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This publication contains all the informa- 
tion needed to make use of the Basic 
Programming Support Basic Utility programs 
provided for users of IBM System/360. The 
utility programs provided are: 


Absolute Loader 

Relocating Loader 

Dump Program 

input/Output Support Package 


These programs are designed to load assem- 
bled programs into main storage; to provide 
listings of the contents of storage; and to 
provide routines for accessing input/output 
devices. The functions and possible modi- 
fications of each program are described in 
detail. 








PREFACE 


This publication provides all the informa- 
tion users need in order to use the IBM 
System/360 Basic Programming Support Basic 
Utility programs. 


To fully understand the material pre- 
sented in this manual, the reader should be 
familiar with the contents of the following 
publications: 


IBM System/360 Basic Programming Support 
Basic Assembler Language, Form C28-6503 


IBM System/360 Principles of Operation, 
Form A22-6821 


In addition, it is suggested that the 
reader be familiar with the following pub- 
lication: IBM System/360 Basic Programmin 
Support Operating Guide for Basic Assembler 
and Utilities, Form C28-6557. 


This publication is arranged in sections 
which correspond to the major parts of the 
utility program package. Also included are 
appendixes that discuss: 


e Program segment relocation and linkage, 
and 


°® A program capable of creating self- 
loading loaders. 


Illustrations, charts, and examples are 
provided throughout to provide the clearest 
possible presentation. 


MAJOR REVISION (June 1965) 


This revision, which supersedes the 
previous edition, represents Version 2 of 
the subject programs. The changes are 
marked by a vertical bar to the left of the 
revised text; revised illustrations are 
denoted by the symbol e to the left of the 
caption. 


This publication was prepared for production using an IBM computer to update 
the text and to control the page and line format. Page impressions for 
photo-offset printing were obtained from an IBM 1403 Printer using a_ special 
print chain. 


Copies of this and other IBM publications can be obtained through IBM Branch 
Offices. 


A form for readers' comments appears at the back of this publication. It 
may be mailed directly to IBM. Address any additional comments concerning this 
publication to the IBM Corporation, Programming Systems Publications, Depart- 
ment D58, PO Box 390, Poughkeepsie, N. Y. 12602 


© 1965 by International Business Machines Corporation 
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Every installation requires programs to 
perform such common functions as loading an 
assembled program into storage or providing 
a listing of the contents of storage. To 
save the programmer the time and effort 
required to write and modify this type of 
program as job requirements change, IBM 
makes utility programs available to its 
customers. 


IBM SYSTEM/360 BASIC PROGRAMMING SUPPORT 
BASIC UTILITY PROGRAMS 


The four utility programs provided are: 
the absolute loader, the relocating loader, 
the dump program, and the input/output 
support package. 


Absolute Loader 


The absolute loader loads program seg- 
Ments (the output of an assembly is called 
a program segment; a program may be com- 
posed of one or more segments) into storage 
at the addresses assigned to them by the 
assembler and transfers control to a pro- 
gram Segment for execution; it also allows 
the user to make corrections or additions 
to the program segments at load time. | 


Relocating Loader 


The relocating loader can load program 
segments into storage at locations other 
than those assigned by the assembler; it 
completes linkage among the segments so 
that one program segment may refer to 
another; it allows corrections or additions 
to be made to the program segments at load 
time; and it transfers control to one of 
the loaded segments for execution. 


Dump Prog ram 


The dump program provides a listing of 
the contents of all or part of storage, the 
general registers, and floating-point reg- 
isters (or any combination of these). The 
program will edit the listing to fit any of 
eight. basic formats, which are described in 
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“Output Formats." The dump program is 
available in a single-phase symbolic ver- 
sion, a Single-phase assembled version, a 
single-phase self-loading version 
(self-loading dump), a symbolic two-phase 
version, an assembled version of phase 1, 
and a self-loading version of phase 2. 


Input/Output Support Package 


The input/output support package 
consists of a modular set of subroutines 
which enable the user to utilize 
input/output devices. (A module in the 


input/output support package is a logical 


sequence of coding which either sets up or 
executes one I/O function.) These are 
routines to read or punch a card, write on 


the message or printer device, sense infor- 
mation from a device, single space on the 
message or printer device, skip to channel 
one on the printer, read or write tape, 
write a tapemark, rewind tape, backspace 
tape a record or file, forward-space tape a 
record or file, and to read tape backward. 


MACHINE REQUIREMENTS 


The IBM System/360 Basic Programming 
Support Basic Utility programs require the 
following minimum machine configuration: 


1. IBM System/360 with 8,192 bytes of 
storage, 


2. One IBM 2540 or 1442 Card Reader- 


Punch, 

3. Standard instruction set, 

4. IBM 1403 OR 1443 Printer, or the IBM 
1052 Printer-Keyboard if the dump 
program is being used, 

The user's input/output configuration det- 


ermines what routines he can use from the 
input/output support package. 


MAIN STORAGE REQUIREMENTS 


The following is an approximation of how 
much storage each of the utility programs 
will occupy. (The user should also take in 
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to account that locations 0-127 should be 
added when figuring available storage.) 


Bytes of 
Program Storage Space 
Absolute Loader 2,580* — 
Relocating Loader 3,800* 
Dump (Phase 1 of 2) 3,100* 
Dump (Phase 2 of 2) 6,350** 
Dump (single phase) 4,460 
Dump (self-loading) 3,000 


I/O subroutine 800-2, 720*+#* 

* In the versions of the absolute and 
relocating loaders supplied by IBM, 
there is a 250-byte sequence of coding 
(Initial Entry Routine) that the load- 
ers use to determine the system's con- 
figuration. Since this 250-byte area 
may be overlaid by a program segment at 
execution time, it is not included in 
these approximations. 


** Needs minimum of 8K to operate. Uses 


remainder of 8K as buffer. 


**+ The bytes of storage occupied by . the 
I/0 subroutines depend on the 
installation's requirements. 


If the user selects the modules neces- 
sary for his installation from the I/0 
support package and keeps them resident in 
storage, the I/0 modules can be removed 
from the program and the programs modified 
by reassembly to link with the I/0 of the 
installation. If this is done, these 
approximations would be greatly reduced. 


The maximum length program which can be 
loaded by the relocating loader on an 8K 
configuration is 4,250 bytes, decreased by 
12 bytes for each ESD card in the deck to 
be loaded. Therefore, the use of the 
relocating loader is recommended only for 
users with greater then 8K bytes of stor- 
age. 
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The absolute loader loads program seg- 
ments into the storage locations assigned 
by the assembler. The absolute loader 
will not overlay itself: any attempt to do 

oader recognizes as input three types of 
load cards. Two of these, the Text (TXT) 
and Load End (END) cards, are generated by 
the assembler; the Replace (REP) card, if 
needed, must be supplied by the programmer. 
The absolute loader will also accept pro- 


gram segments intended for use by the 
relocating loader, with the following 
exceptions: 








1. All other cards, including the load 
cards recognized only by the relocat- 
ing loader -- the Set Location Counter 
(SLC) , Include Segment (ICS), External 
Symbol Dictionary (ESD), Relocation 
List Dictionary (RLD), and Load Termi- 


nate (LDT) cards - are ignored. 
Information meaningful only to the 
relocating loader in the Text, 
Replace, and Load End cards is also 
ignored. 


2. Linkage with another program segment 
is not supplied. If one program seg- 
ment must refer to instructions or 
data in a separate program segment, 
absolute addresses must be used. 


3. Two or more program segments can be 
loaded one after the other if all END 
cards are removed except the END card 
after the last program segment. 


The absolute loader is available as 
follows: 
Table 1. Absolute Loader Functions 


| 

k 

| Loading: Places the instructions and/or 
| constants of a program segment into 

| the storage locations assigned by the 

| assembler. 
| 
| 
| 
| 
| 
| 
| 


Correcting: Allows changes or additions 


to the instructions and/or constants within 


the program segment at load time. 


Transferring Control: Ends loading of the 


program segment and transfers control 


to some location within the program segment. | 


bee ae ne mere mere me emer are A NE pm A Se a ce tt ce a Se cee 





ABSOLUTE LOADER 


1. a symbolic deck. 


2. a self-loading, nonrelocatable deck 


(assembled in lower storage) . 


3. a self-loading, nonrelocatable deck 
(assembled in high storage for an 8K 
configuration) . 


If the user wants to employ the _ self- 
loading deck, he may have to make the 
following changes to the END card in the 
self-loading deck: 

1. He must punch (in hexadecimal 
notation) the address of the input 


device into card columns 17-20, if the 
address of the input device is 
different from the address that the 
loader is to be loaded from. If it is 
not different, he may leave it blank. 


2. If he desires to use a message or 
printer device for error indications, 
he must punch (in hexadecimal 


notation) the address of his typewrit- 
ing device into card columns 21-24. 
If there is no typewriter, he must 
punch the address of the printer. If 
he leaves these columns blank, the 
error indications will only be dis- 
played on the console. 


ABSOLUTE LOADER FUNCTIONS 


The functions of the absolute loader and 
the cards associated with each function are 
listed in Table 1. 


One or more Text cards containing 
the instructions and/or constants of 
the user's program segment, and 
their assigned starting address. 


corrections altering the program 
segment. 


Load End card containing an address 
within the program segment to 
which control will be transferred. 


chee oa Se 


—— + 4 


| 
| 
| 
| 
{ 
One or more Replace cards containing | 
| 
| 
| 
| 
| 
| 
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PROGRAM SEGMENT SEQUENCE 


A program segment ready to be loaded 
includes at least two types of cards: Text 
cards anda Load End card. A Replace card 
is inserted by the programmer only if he 
desires to change and/or add to the program 
segment at load time. 


Figure 1 shows a program segment with a 
Replace card inserted by the programmer, 
ready for loading by the absolute loader. 
(The figure is read from the bottom up.) 


Dep et ene eas pe nan 1 
| | END --Causes the loading process | 
| to end and control to be | 
| transferred to the user's | 
| program segment. i 
| | REP --Makes additions and/or | 
| changes to the internal | 
| format in storage. | 
| | TXT -~-User's program segment: | 
| Assembled instructions | 
| and/or constants. | 
| | 
es ee 


Figure 1. The Sequence of a Program Seg- 
ment Ready to Be Loaded by the 


Absolute Loader 


CARD FORMATS 


The three types of load cards recognized 
by the absolute loader are defined in 
detail in the foliowing sections. The 
function of each card is stated briefly, 
with any other information pertinent to its 


use. The card formats are shown in tabular 
form, with each field of the card 
explained. 

In most cases, values in load cards 


produced by the assembler are represented 
in IBM extended card code; for example, the 
decimal value 20 -- represented in one byte 
as 0001 0100 -- becomes an 11-9-4 punch in 
one card column. In contrast, the program- 
mer uses the more convenient hexadecimal 
code if Replace cards are used. The hexa- 
decimal equivalent of decimal 20 is 14; 
this is a 1 punch and a 4 punch in two 
successive card columns, representing the 
contents of one byte. (Tables for conver- 
Sion from decimal to hexadecimal are in 


Appendix B of IBM System/360 Basic Program- 
ming Support Basic Assembler Language, Form 
C28-6503.) 


TEXT CARD 


The Text card contains, in extended card 
code, the following: 


1. The starting address in storage where 
the assembled instructions and con- 
stants of the user's program segment 
are to be inserted. 


2. The number of bytes of information 


contained in the card. 


3. The text itself; that is, the assem- 
bled instructions and/or constants 
contained in the card. 


Each Text card may contain a maximum of 56 


bytes of text. Table 2 defines the con- 
tents of the Text card fields. 

Table 2. Text Card 

aaa Ness ee ee ee en 1 
| Column Contents | 
a a a ae ae Ea | 
| | Load card identification | 
| | (12-2-9 punch) . Identifies | 
| | this as a card acceptable to | 
| | the Loader. | 
| | | 
| 2-4 | TXT. Identifies the type of | 
| | load card. ; | 
| [ | 
| 5 | Blank. | 
| { | 
{| 6-8 | The starting address, in | 
|. | extended card code, where the | 
| | information on the card is to | 
| | be loaded into storage. | 
| | | 
| 9-10 | Blank. | 
| | | 
| 11-12 | Number, in extended card code, | 
| | of bytes of text to be loaded | 
| {| from the card. | 
| | | 
{| 13-14 {| Blank. | 
| | | 
| 15-16 | Information for the relocating | 
| | loader. The content of these | 
| | columns is ignored by the abso- | 
| | lute loader. | 
| | | 
| 17-72 | From 1 to 56 bytes of text -- | 
| | instructions and/or constants | 
| | assembled in extended card | 
| | code. | 
| | | 
| 73-80 | Not used by the loader. The | 
| | programmer may leave blank or | 
| | punch in program identification | 
| | for his own convenience. | 
(ae een EM eae ne a Jj 


REPLACE CARD 


The Replace card is 
programmer, and must be 
program segment following the 


supplied by the 

placed in the 
Text cards 
| Both assem~- 
bled instructions and constants may be 
changed or additions made. However, all 
changes and additions must be punched in 
hexadecimal code. 


The programmer cannot replace a two- 
byte instruction with a four-byte 
instruction through the load program. 
In order to replace a two-byte instruc- 
tion with a four-byte instruction, he 
must either reassemble his source pro- 
gram or patch; that is, replace the 
incorrect or old entry with a branch 
instruction to some storage location 
into which the replacement will be load- 
ed. Replacement must be made byte for 


byte. 


Table 3 defines the contents 
Replace card fields. 


of the 


Table 3. Replace Card 


Cee ee ee Ste a age eC any mee me ea eee ah 


Contents 


identification 
(12-2-9 punch) . Identifies 
this as a card acceptable to 
the loader. 

the 


REP. Identifies 


load card. 


type of 


Blank. 


| 

| 

| 

i 

| 

| 

| 

| 

| 
Address, in hexadecimal, of the | 
area to be replaced. It must | 
be right-justified in these | 
columns, and unused leading | 
columns filled in with zeros. | 
The address must specify a | 
half-word boundary. | 
i 
13-16 Blank. | 
| 
17-70 A maximum of 11 four-digit | 
hexadecimal fields, separated | 
by commas, each replacing one | 
loaded half-word | 

The last field | 

not be followed by a | 

| 

| 

| 

| 

| 

| 

| 

| 


previously 
(two bytes). 

must 
comma. 


Blank. 


Not used by the loader. The 
programmer may leave blank or 
punch in program identification 
for his own convenience. 


ra nn A a a a a a re ee ee en 


[ 
aa 
| 
| 
| 
| 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
i 
L 


LOAD END CARD | 


The Load End card ends the loading 
process and causes control to be trans- 
ferred to some location within the program 
segment. If a location is not specified in 
the END card, control is transferred to the 
first location in storage loaded into from 
a TXT card (or REP card, if there are no 


TXT cards) above 127 decimal, or 7F hexa- 
decimal. After control is transferred, the 


system operates in the Supervisor state 

disabled for all interruptions, except a 
machine check interrupt; see “Input/Output 
Support Package" for a discussion of inter- 


ruptions. Table 4 defines the contents of 
the Load End card fields. 


Table 4. Load End Card 


identification 
(12-2-9 Identifies 
this asa 

the loader. 


punch) . 
card acceptable to 


END. Identifies the 


load card. 


type of 


4 
| | 
| | 
| | 
| | 
i | 
| | 
| | 
| | 
| Blank. | 
| | 
| Address, in extended card code, | 
| of a point in the program seg- | 
| ment to which control is to be | 
| transferred at load _ end. If | 
| the END card did not specify a | 
| point in the program segment to | 
{ which control is to be trans- | 
| ferred, this field will contain | 
| blanks and control will be | 
| transferred to the first loca- | 
| tion in storage above location | 
| 127 decimal, or 7F hexadecimal, | 
| into which data is loaded from | 
| a TXT card (or REP card, | 
| precedes the TXT cards). i 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
I | 
| | 
| | 
| | 
| | 
1 J 


if one 


9-14 Blank. 


15-16 Information for the relocating 
loader. The content of these 
columns is ignored by the abso- 
lute loader. 


17-72 Blank. 


73-80 Not used by the loader. The 
programmer may leave blank or 
punch in program identification 
for his own convenience. 


ee ee ec ce SS a a a es a 
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LOADER USE OF I/O SUPPORT PACKAGE 


The absolute loader uses selected 
modules of the I/O support package to read 
cards or card images from tape. These 
routines can be used by the programmer by 
employing the coding sequence (with abso- 
lute addresses) discussed in “Input/Output 
Support Package." 
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RESIDENT LOADER CONSIDERATIONS 


The name of the first instruction in the 
absolute loader is: LOAD1. If this loca- 
tion is branched to (either from the con- 
sole or directly from a program segment in 
storage), another program segment can be 
loaded without preceding it by another 
absolute loader. The user may obtain the 
absolute address of LOAD1 by referring to 
his listing. 


INTRODUCTION 


. The distinguishing feature of the relo- 
cating loader is its ability to relocate 
program segments and to complete linkage 
between the segments. (For a detailed 
discussion on how the relocating loader 
accomplishes this, see Appendix A.) It also 
has a storage mapping facility which will 
provide, on the message device indicated on 
the END card, the name of each segment and 
entry point and its assigned location. The 
relocating loader recognizes eight types of 
load cards. Four of these are generated by 
the assembler: the External Symbol Dic- 
tionary card (ESD), Text card (TXT), Relo- 
cation List Dictionary card (RLD), and the 
Load End card (END). The other four cards 
are supplied by the programmer: the Set 
Location Counter card (SLC) Include Segment 
card (ICS), Replace card (REP), and Load 
Terminate card (LDT). 


The relocating loader protects itself 
and the Reference Table (REFTBL) from being 
overlaid when input is in relocatable form. 
The Reference Table is a list of 12-byte 
entries (a maximum of 253 entries) built by 
the loader; it contains the names and entry 
points of a program segment along with 
their present internal location and _ the 
relocation factor. When an attempt is made 
to overlay the loader or the Reference 


Table an error wait results. (For a dis- 
cussion of codes and operator actions on 
any error waits mentioned in this manual, 


see IBM System/360 Basic Programming Sup- 


port Operating Guide for Basic Assembler 
and Utilities, Form C28-6557.) When the 


relocating loader is requested to function 
as an absolute loader, it does not protect 
the Reference Table, and the Reference 
Table can be overlaid. 


LOADING CAPACITY 


The Relocating Loader available from IBM 
is set for a maximum storage size of 8K. 
To modify the Relocating Loader source 
deck, designed for residence in lower stor- 
age, for a storage size greater than 8K it 
is necessary to alter the constant TOP as 
described prior to the constant in the 
listing (or to 131071 for 128K). The 
source deck should then be assembled and a 
new loader generated using the LDRGEN pro- 
gram. For further information about loader 
options and modifications and how to use 


RELOCATING LOADER 


the Loader Generator Program, refer to the 


IBM/360 Basic Programming Support, Operat-— 


ing Guide for Basic Assembler and _ Utili- 
ties, Form C28-6557. 


The is available as 


follows: 


relocating loader 


1. A symbolic deck. 


2. A self-loading, nonrelocatable deck 
(assembled in lower storage) for an 8K 
configuration. 

3. A self-loading, nonrelocatable deck 


(assembled in higher storage) for an 


8K configuration. 


If the user wants to employ the self- 
loading deck, he may have to modify the END 
card in the self-loading deck as follows: 


1. Punch (in hexadecimal notation) the 
address of the input device into card 
columns 17-20, if the address of the 
input device is different from the 
address that the loader is to be 
loaded from. If it is not different, 
he may leave it blank. 


2. If he desires to use a message or 
printer device for error indications, 


he must punch (in hexadecimal 
notation) the address of his 
typewriting or printing device into 


card columns 21-24. If there is no 
typewriter or printer, he must punch 
the address of the printer. If he 
leaves these columns blank, the error 
indications will only be displayed on 
the console. 


Finally, the relocating loader contains 
its own location counter (LOCCT); LOCCT 
determines where program segments will be 
loaded. LOCCT is set to a constant value 
during an initial program-loading proce- 
dure. Once LOCCT is set, it is subsequent- 
ly incremented by the number of bytes 
indicated on an ESD Type 0 card (see “ESD 
Type 0 (Program Name)"). It may also be 
incremented by the length indicated on an 
IcS card (see “Include Segment Card") or 
set by an SLC card (see “Set Location 
Counter Card"). 
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UNIQUE RELOCATING LOADER FUNCTIONS 


The relocating loader has not only the 
three functions of the absolute loader 
(that is, loading, correcting, and trans- 
ferring control), but also the unique capa- 
bilities described in Table 5, by function 
and the associated control cards. 


CARD FORMATS 


The eight types of load cards recognized 
by the relocating loader are described in 
detail in the following sections. The 
function of each card is stated briefly, 
with any special considerations in its use. 
The card format is shown in tabular forn, 
and each field of the card is explained. 


Particular attention has been given to 
those cards that the programmer supplies 
(the Set Location Counter, Include Segment, 
Replace, and Load Terminate cards) and to 
those cards whose function is. closely 
related to other cards. 


SET LOCATION COUNTER CARD 


The Set Location Counter card sets’ the 
leader location counter in one of three 


1. Any absolute address, specified as a- 
hexadecimal number punched in card 
columns 7-12. 


2. Any symbolic address already defined 
aS a program name or entry point. 
This is specified by a symbolic name 
punched in card columns 17-22. 


3. If there is both a hexadecimal address 
and a symbolic name, the absolute 
address (converted to binary) will be 
added to the internal address assigned 
to the symbolic name, and the result- 
ing sum will be the address to which 
the loader's location counter is set. 
To illustrate this, we will assume 
that in card columns 7-12 of the Set 
Location Counter card, O0007F was 
punched; also that there is a symbolic 
address called GAMMA and that GAMMA is 
at storage location 000100 
(hexadecimal). The absolute address 
in card columns 7-12 will be added to 
the internal address assigned to 
GAMMA, giving a sum of 00017F. It is 


at this location in storage that the 
loader's location counter will be set. 
(See "Note" under “Include Segment 
Card.") 


-If there are blanks in both card columns 
7-12 and 17-22, there will be an error 
wait. If the programmer wishes to use only 
the symbolic address, he must leave the 
absolute field blank (or all zeros); if he 
wishes to use only the absolute address, he 


ways: must leave the symbolic field blank. 

Table 5. Unique Relocating Loader Functions 
re er i Se Se Ove ee at ee ee eee E 
| Functions | Cards | 
~~~-~--~~-----~---------------------+---------- f= ------- === === -=-------------+ 


Relocating. 


locations other than those assigned by the 
assembler; that is, relocate them. 


Linkage. 
one after the other, and completes linkage 


another program segment. 
are used by the program segment. 


Transferring Control. Ends loading 





Oe rp re re re ce es re cree ce re ee ee cme ee EE eee oe ae co 
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Can place the instructions and 
constants of a program segment into storage 


| 

| 

| 

| 

| 
Loads two or more program segments | 
| 

among them, so that one program segment may | 
refer to constants and/or instructions within | 
| 

| 

| 

{ 

| 

| 

| 


(Makes any changes 
necessary in evaluating address constants which 


and causes 


LE ES ARE a a SA RE SS SS SS SE a SS SS OS Se 


{| Set Location Counter (SLC), 
Include Segment (ICS), 
External Symbol Dictionary 
(ESD, type 0), Text (TXT), 
Replace (REP) . 


External Symbol Dictionary 


| 
| 
| 
| 
| 
| 
(ESD types 1 and 2), Relocation List | 
Dictionary (RLD), Replace (REP). | 
| 
| 
| 
| 
| 
| 
| 
| 
| 


Load Terminate (LDT) and Load 


control to be transferred according to the End (END) . 

priority noted in the discussion of the Load 

Terminate card. | 
a n= | 
Note: The function of the Replace card is essentially the same as in the absolute i 
loader. The Load End card remains an essential part of each program segment, but is | 


subordinate in function to the Load Terminate card. | 


es a a en a a en a toe Jj 


In the abSence of an initial SLC card, 
‘LOCCT is set to the first location availa- 
ble for loading above 127 decimal or 7F 
hexadecimal. 


Table 6 defines the contents of the Set 
Location Counter card. 


Table 6. Set Location Counter Card 


AO eC OR Se NS SR RS SS I ES SS OE ER HE SES NR mt URN tnt eR ce 


Contents 


| 
I 
| 
| 
| 
{ 
I 
I 
| 
| 
| 
| 
| 
I 
I 
{ 
| 
| 
{ 
| 
{ 
| 
{ 
| 
l 
| 
I 
I 
t 
| 
| 


OS ae | 


identification 
Identifies this as a 
loader. 


Load 
(12-2-9) . 
card acceptable to the 


card 


SLC. 
load card. 


Identifies the type of 


+. 
| 
| 
| 
| 
| 
| 
| 
| 
7-12 | Address in hexadecimal (to be 
| added to the value of the sym- 
| bol, if any, in columns 17-22). 
| The address must be right- 
| justified in these columns, and 
| unused leading columns filled 
| in with zeros. 
| 
13-16 | Blank. 
| 
17-22 { Symbolic name, whose internal 
| assigned location will be used 
| by the loader. The symbol must 
| be left-justified in these 
| If left blank, the 
| absolute field 
| 
| 
| 
| 
| 
| 
| 
| 
t 


columns. 
address in the 
is used. 


23-72 Blank. 


73-80 Not used by the loader. The 
programmer may leave blank or 
punch in program identification 
for his own convenience. 


[Ee ee ct eee Se EE RD SR RE A A TT A LS TS SS SO SO 


| 
| 
| 
| 
| 


INCLUDE SEGMENT CARD 


If program segment A is to be loaded, 
and it makes reference to a program segment 
named B, the relocating loader requires 
that the location of segment B must be 
already established. This requirement may 
be satisfied in one of two ways: 


1. Load segment B first, or 
2- If segment B has not been loaded, the 


programmer must precede segment A with 
an Include Segment (ICS) card. This 





card will define segment B by name and 
length. 


Assuming that segment B has not been 
loaded but has been defined by name and 
length, the loader then includes segment B 
in its Control Dictionary and reserves an 
area of storage for it. (The Control 
Dictionary is comprised of the Reference 
Table and the External Symbol Identifi- 
cation (ESID) Table. The ESID Table con- 


tains pointers to the entries in the Ref- 
erence Table that refer to the current 
program segment.) When the loader subse- 


quently encounters reference to segment B, 
the actual location of B is already known. 


When segment B is loaded, it is placed 
into the storage area reserved for it. The 
programmer must specify in the ICS card a 
value not less than the actual length of 
segment B (the length of segment B is not 
retained by the loader and so overlay 
checks are neither made nor verified). 
However, if another segment to be loaded, 
C, makes reference to another entry point 
within program segment B, then the assem- 
bled instructions and constants of B must 
either be loaded before segment C, or 
defined for C through an ICS card. 


Entry points other than those already 
established (by an ENTRY assembler 
instruction) can be established in the same 
manner. To establish this type of entry 
point, the programmer takes the following 
steps: 


1. He provides an SLC card that sets the 
location counter to the desired 
address. See item 3 under "Set Loca- 
tion Counter Card." 


2. He provides an ICS card that indicates 
a program segment with a length of 
Zero. 


Note: Program segments are loaded only on 
double-word boundaries. The loader auto- 
matically makes this adjustment before 
loading any given segment according to the 


following criteria: 


1. If the ICS card denotes a symbol of 
length 0, no adjustment is made to 
LOCCT, and the symbol is placed in 
REFTBL with the current value of LOCCT 
assigned to it. 


2. If the ICS card denotes a symbol with 
a length greater than 0, then the 
following operations occur: 


a. LoccTtT is 
double-word 
necesSary) . 


adjusted to the next 
boundary (if 


Relocating Loader 13 


b. the symbol goes into REFTBL with 
the value of LOCCT. 


c. the length of the symbol is added 
to the value of LOCCT, and LOCCT 
is set to the resulting sum. 

Table 7 defines the contents of the 
Include Segment card fields. 


Table 7. Include Segment Card 


Contents 

}------- }-------------------------------—- 
| 1 Load card identification 

(12-2-9). Identifies this as a 

card acceptable to the loader. 


Ics. Identifies 
load card. 


the type of 


5-16 Blank. 


7-22 Name of segment, left-justified 
in these columns. 


23-24 Blank. 


25-28 Length (in bytes) in hexadeci- 
mal notation of the program 
segment. This must not be less 
than the actual length of the 
segment. (This may be 0 if the 
IcS card is used to add entry 
points other than for defining 
program segments.) The number 
must be right-justified in 
these columns, and unused lead- 
ing columns filled in with 
zeros. 


Blank. 


Not used by the loader. The 
programmer may leave blank or 
punch in program identification 
for his own convenience. 


be acco NE a a 


en nen ee eee St 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
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EXTERNAL SYMBOL DICTIONARY CARD (ESD) 


ESD Type 0 (Program Name) 


The External Symbol Dictionary card, 
Type 0, defines the name of the program 
“segment. The program name is also an entry 
‘point to the segment. It is produced by 
the assembler when it encounters a START 
instruction. If the START instruction does 
not specify a program name or if there was 
no START card, BLANKS will be placed in the 


loader's Control Dictionary and will define 
the “name" of that program segment. 
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The assembler assigns an External Symbol 
Identification number of 01 (ESID 01) to 
the program segment. This number is used 
by the loader as a control (in the Control 
Dictionary) to the Reference Table. It is 
at this time, that is, when the loader is 
processing the ESD (Type 0) card, that the 
loader computes the segment"s relocation 
factor. The relocation factor is the dif- 
ference tween the address where the pro- 
‘gram Seqment is loaded and the address 
where it was assembled. The loader Saves 

e relocation factor in the Reference 
Table. The ESID 01 appears in the ESD 
Type 0, all ESDs Type 1, TEXT, RLD, and the 
Load End (END) cards produced by the assem- 
bler. 


The starting address at which the pro- 
gram segment will be loaded is determined 
by the following conditions: 


1. If the name of the segment defined by 
the ESD Type 0 card is contained in 
REFTBL, then the segment is loaded 
beginning at the location specified in 
REFTBL and no adjustment of LOCCT is 
made. 


2. If the name of the segment specified 
in the ESD Type 0 card is not in 
REFTBL, then the following occur: 


a. LoccT is adjusted to the next 


double-word boundary (if neces- 
sary) . 
b. the segment name is placed in 


REFTBL with the adjusted value of 
LOCCT. 


c. the length of the segment is added 
to the adjusted value of LOCCT, 


and LOCCT is set to the resulting 
sum. 
d. the segment is loaded starting at 


the location specified in REFTBL. 


The loader loads only one program seg- 
ment at a time and does not save the 
identifying number from one program segment 
to another. Therefore, there is no con- 
flict in the table when the next segment is 
assigned the same identifying number; that 
is, the next program segment loaded may be 
assigned an identifying number of 01 (ESID 
01). 


This routine maps the segment's name and 
its assigned location. 


of the 
card 


defines the contents 
External Symbol Dictionary 


Table 8 
Type 0 
fields. 


Table 8. ESD Card Type 0 (Program Name) 

Se a Po a ee ee ee ee 
| Column | Contents | 
—~--—— | —-~---- -----------------------— { 
} 1 | Load card identification | 
| | (12-2-9). Identifies this as a | 
| | card acceptable to the loader. | 
| | | 
j 2-4 | ESD. Identifies the type of | 
| {| load card. | 
| | | 
| 5-10 | Blank. | 
| | | 
| 11-12 | The number of bytes in the | 
| | card. Extended card code | 
| | 12-0-1-8-9 and 12-11-1-8-9 | 
| | (hexadecimal value of 0010). | 
| | | 
| 13-14 | Blank. | 
| | | 
| 15-16 | External Symbol Identification | 
| | (ESID). Number, in extended | 
| | card code, assigned to the pro- | 
| | gram segment. | 
| | | 
{| 17-22 | Program name. | 
| | | 
| 23-24 | Blank. 7Z r 
| | ag | 
| 25 | Extended card code 12-0-1-8-9 | 
| | (hexadecimal value of 00), | 
| {| identifying this as a program | 
| | name card. | 
| | | 
| 26-28 | Address, in extended card code, | 
| | of the first byte of the pro- | 
| | gram segment as assigned by the | 
| | assembler. | 
| | | 
{| 29 | Blank. | 
| | | 
| 30-32 | Number, in extended card code, | 
| | of bytes in the program seg- | 
| { ment. | 
| | | 
{| 33-72 | Blank. | 
| | | 
| 73-80 | Not used by the loader. The | 
| | programmer may leave blank or | 
| | punch in program identification | 
| | for his own convenience. | 
ee ee re __J 


ESD Type 1 (Entry Point) 


The Type_.1  Externa ictionary 


card Sef fee an OHEES point withiny Eee 
program segment to which another ségien 


May refer. This card is produced by the 
assembler when it encounters an ENTRY 
assembler instruction, one card being pro- 
duced for each entry point so defined. All 
ESD Type 1 cards are assigned the same ESID 
as that of the ESD Type 0 of the same 
program segment. Duplicate entries will 


cause a loader error wait. (See the publi- 


cation IBM System/360 Basic Programming 


Support Operating Guide for Basic Assembler 
and Utilities, Form C28-6557.) There may 


not be more than 100 ENTRYS for a given 
program segment. 


To enable reference to an entry point in 
one program segment, another segment must 
define it within its own assembly as an 
external symbol. However, entry points 
need not be predefined if they are not 
referenced during the load. This routine 
Maps each entry point and its assigned 
location. 


Table 9 defines the contents of the Type 
1 External Symbol Dictionary card. 


Table 9. ESD Card Type 1 (Entry Point) 
oS Dt cag a ge ae ore eg Re es 1 
{ Column| Contents | 
[--------—-~----------------------------| 
1 | Load card identification | 
(12-2-9) . Identifies this as a | 
{| card acceptable to the loader. | 
| | 
2-4 j ESD. Identifies the type of | 
| load card. | 
| | 
5-10 | Blank. | 
| | 
11-12 | The number of bytes in the | 
{| card. Extended card code | 
| 12-0-1-8-9 and 12-11-1-8-9 | 
| (hexadecimal value of 0010). { 
| | 
13-16 | Blank. | 
| | 
17-22 | Name of entry point. | 
| | 
23-24 | Blank. | 
| | 
25 | Extended card code 12-1-9 | 
| (hexadecimal value of 01), |{ 
| identifying this as an entry | 
| point card. | 
| | 
26-28 | Address, in extended card code, | 
| of the entry point as assigned | 
| by the assembler. | 
| | 
29-30 | Blank. | 
| | 
31-32 | External Symbol Identification | 
| (ESID). Number, in extended | 
| card code, assigned to program | 
| segment in which entry points | 
{| occur. | 
| | 
33-72 | Blank. | 
| | 
73-80 | Not used by the loader. The | 
| programmer may leave blank or | 
| punch in program identification | 
| for his own convenience. | 
Mh a ace 
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ESD Type 2 (External Symbol) 


The Type 2 External Symbol Dictionary 
card points to a name within another pro- 
gram segment, to which this segment may 
refér. e card iS produced by the assem- 


er when it encounters an EXTRN instruc- 
tion, one card being produced for each 
external symbol so defined. The assembler 


assigns each External Symbol a unique ESID. 
The ESIDs range from 2 throtg an so 
there may not be more than 14 in any given 
program segment... ~~” 


The ESID is used aS a pointer to the 


Reference Table which includes: 


1. The external program segment name or 
entry point. 


2. Its actual internal address. 


The same ESID number appears in the RLD 
card associated with the external symbol. 


The loader loads only one program seg- 
ment at a time. It saves names from one 
segment to the next, but not identifying 
numbers. Therefore, there is no conflict 
in the tables when the sequence of ESIDs 
reappears. To reference an external sym- 
bol, that symbol must be declared an entry 
point in some other segment (unless it is 
the name of the program segment) . 


Table 10 defines the contents of the 
Type 2 External Symbol Dictionary card 
fields. 

SUMMARY OF EXTERNAL SYMBOL DICTIONARY 
CARDS : The External Symbol Dictionary 
cards are generated by the assembler. 


There are three types of ESD cards: 


1. | ESD Type 0 defines the name, starting 
address, and length of a program seg- 
ment. It is produced by the assembler 
when the assembler encounters a START 
assembler instruction. There is only 
one ESD Type 0O card produced per 
program segment; it is assigned an 
ESID of 01 by the Basic Assembler. 


2. {ESD Type 1 defines an 
within the program segment to which 
another segment may refer. It is 
produced by the assembler when the 
assembler encounters an ENTRY assem- 
bler instruction. One card is pro- 
duced for each entry point so defined. 


entry point 
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Table 10. ESD Card Type 2 (External 
Symbol) 


| Column | Contents 


[-------4-------------------------------- 


1 identification 
Identifies this asa 


card acceptable to the loader. 


card 
(12-2-9) . 


ESD. Identifies the 


load card. 


type of 


5-10 Blank. 


11-12 The 

card. 
12-0-1-8-9 
(hexadecimal value of 0010). 


in the 
code 


number of bytes 
Extended card 


and 42=11-1-8-9 


13-14 Blank. 


7 
| 

4 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

15-16 External Symbol Identification | 
(ESID) . Sequential number, in | 
extended card code, assigned to | 
external symbol. | 
| 

17-22 Name of external symbol. | 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

{ 

| 

J 


25 12-2-9 
iden- 


external 


Extended card code 
(hexadecimal value of 02) 
tifying this as an 
symbol card. 

26-28 Extended card code 12-0-1-8-9, 
12-0-1-8-9, and 12-0-1-8-9 
(hexadecimal value of 000000). 
An address of 0 is always 
assigned to External Symbols by 
the Basic Assembler. 


29-72 Blank. 


73-80 Not used by the loader. The 
programmer may leave blank or 
punch in program identification 
for his own convenience. 


ee ec TE EE A A A eS SE 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
7 
23-24 | Blank. 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
a 


to a name within 
another program segment to which this 
program segment may refer. It is 
produced by the assembler when the 
assembler encounters an EXTRN assem- 
bler instruction. 


3. {ESD Type 2 points 


The assembler asSigns the external sym- 
bol an identifying number of from 2 through 
15 (according to the order in which it is 
encountered among the segment's external 
symbols) . 


TEXT CARD 


The Text card contains instructions 
and/or constants of the user's program 
segment and the starting address at which 
the first byte of text is to be loaded from 
the card. Each card contains a maximum of 


56 bytes of text, in extended card code. 


Table 11 defines 
Text card fields. 


the contents of the 


RELOCATION LIST DICTIONARY CARD 


The Relocation List Dictionary card 
(RLD) is produced by the assembler when it 
encounters a DC instruction or the second 
operand of a CCW instruction which defines 
an address as a relocatable symbol or 
expression. This may be the address of 
either an internal symbol, which occurs 
only within the program segment, or of an 
external symbol belonging to another seg- 
ment (ESID with an identifying number of 
from 2 through 15; see “ESD Card Type 2 
(External Symbol) .* 


For example, in program segment A, the 
programmer wishes to refer to a subroutine, 
SORT, in segment B. He defines it as an 
external symbol: 

EXTRN SORT 
Now he may branch to it within his 
segment in the following manner: 


program 
r? "45, ADSORT 
_BALR 14,15 


Because he does not know what its address 


will be at load time, he uses aie symbolic 
address: 

ADSORT DC A (SORT) 
In this example, SORT is an external, 


relocatable symbol, whose value will change 
as a result of peor being, relocated. 
The assembler assign a value of 
zero, and when the address for SQRT is 
defined at load time, this value is added 
to zero. A segment may contain more than 
one symbol or expression definable in terms 
of one relocatable symbol. For example: 


Table 11. Text Card 

ee cee eee eee Sone ceeee ee eee <tc emt etme pene SD SED ESS ED ee SS ED A yD ES TS ED ED DD SD SS GD 1 
{| Column | Contents | 
area ; ea ann aes Cea 
{| 1 | Load card identification | 
| {| (12-2-9). Identifies this as a | 
| | card acceptable to the loader. | 
| | | 
| 2-4 | TXT. Identifies the type of | 
| | load card. | 
| | { 
{ 5 | Blank. | 
| | | 
{| 6-8 {| 24-bit starting address (in | 
| | extended card code) in storage | 
| | where the information from the | 
| | card is to be loaded. | 
| | { 
{| 9-10 | Blank. | 
| | | 
| 11-12 | Number of bytes (in extended | 
| | card code) of text to be loaded | 
| | from the card. | 
| | | 
{ 13-14 | Blank. | 
| [ | 
| 15-16 | External Symbol Identification | 
{ | (ESID). Number, in extended | 
| | card code, assigned to the pro- | 
| | gram segment in which the text | 
| | occurs. | 
| | | 
| 17-72 | A maximum of 56 bytes of | 
| |} instructions and/or constants | 
| | assembled in extended card | 
| | code. | 
| { | 
| 73-80 | Not used by the loader. The | 
| | programmer may leave blank or | 
| j punch in program identification | 
l | for his own convenience. | 
set See ne ee 

ADSORT DC A (SORT) 

ADSOR1 DC A (SORT+10) 

ADSQR2 


DC A (SORT+20) 


The RLD card lists addresses for as many 
as 13 expressions so defined. If there are 
more than 13 such expressions, other RLD 
cards associated with the symbol are pro- 
duced. 


Table 12 defines the contents of the 
Relocation List Dictionary card fields. 
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Table 12. Relocation List Dictionary Card 


te an nn nn ce a a a a a ee me ee 


| Column | Contents . \ 
}-—-—--—— ------------------------------—-} 

1 Load card identification 
(12-2-9) . Identifies this as a 
card acceptable to the loader. 

2-4 RLD. Identifies the type of 
load card. 

5-10 Blank. 

11-12 Number, in extended card code, 
of bytes of information in the 
variable field (card columns 
17-72) of this card. The range 
is from 8 to a maximum of 56. 

13-16 Blank. 

17-72 Variable field (in extended 


card code). Consists of the 
following subfields: 


Relocation Header. (Two 
bytes.) An ESID with a value 
of from 01 through 15. Whether 


or not the value is 01 or from 
02 through 15 depends on wheth- 
er the symbol it points to is 
internal or external to the 
particular program segment. 


Position Header. (Two bytes.) 
The ESID assigned to this pro- 
gram segment. 


Flag Byte (bits 0 through 3 are 
not used). This byte contains 
three items: 


1. Size. (Bits 4 and 5.) Two 
bits which indicate the 
length (in bytes) of the 


adjusted address (AA Cell) 


a. 00 - one-byte cell 
b. 01 - two-byte cell 
ce 10 - three-byte cell 
d. 11 - four-byte cell 
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Table 12. (Continued) 
I A SR aaa a aa | 
| Column | Contents | 
}-------}--------------------------------4 
2. Complement Flag. (Bit 6.) 
When this bit is a one, it 


means that the value (or 
address) of the symbol is to 
be. subtracted from the con- 
tents of the AA Cell. When 
this bit is a zero, the 
value of the symbol is to be 
added to the contents of the 
AA Cell. 


3. Continuation Flag. (Bit 7.) 
When this bit is a one, it 


INeEeans that this is one of a 
series of addresses to be 
adjusted. When this bit is 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

[ 

| 

| 

| 

| a zero, this is the only AA 
| Cell to be adjusted or the 
| last in a series using the 
| same Relocation and Position 
| headers. 

| 

| Address. The three-byte 
| address of the location of the 
| AA Cell. 

| 

| 

| 

| 

| 

| 

| 

| 

[ 

| 

| 

| 

| 
i 


The Flag Byte and Address 

may be repeated for AA Cells as 
long as_ the continuation flag 
bit is on in the current four- 
byte entry. 
73-80 Not used by the loader. The 
programmer may leave blank or 
punch in program identification 
for his own convenience. 
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REPLACE CARD 


The Replace card is supplied by the 
programmer, and should be placed in the 
program segment immediately following the 
Text cards. Both instructions and 
constants may be changed and/or additions 
made. The Replace card must be punched in 
hexadecimal code. 


If additions made by Replace cards 
increase the length of a program Segment, 
the programmer must place an Include Seg- 
ment card (which defines the total length 
of that program segment) at the front of 
the program segment. 


Table 13 defines the contents of the 


Replace card fields. 


Table 13. Replace Card 

I a a a a a | 
Column | Contents | 
———— | -—-——- —-----—--_--_-_-—- 
1 Load card identification 


(12-2-9) . Identifies this as a 
card acceptable to the loader. 


REP. Identifies the type of 
load card. 


5-6 Blank. 


7-12 Starting address, in hexadeci- 
mal, of the area to be 
replaced, as assigned by the 
assembler. It must be right- 
justified in these columns, and 
unused leading columns filled 
in with zeros. 


13-14 Blank. 


15-16 External Symbol Identification 
(ESID) . Hexadecimal number 
assigned to the program segment 
in which replacement is to be 
made. 

17-70 A maximum of 11 four-digit 
hexadecimal fields, separated 
by commas, each replacing one 
previously loaded half-word 
(two bytes) . The last field 
must not be followed by a 
comma. 


71-72 Blank. 


73-80 Not used by the loader. The 
programmer may leave blank or 
punch in program identification 
for his own convenience. 
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LOAD END CARD 


The Load End card (END) is produced by 
the assembler when it encounters the END 
instruction. This card ends loading of a 
program segment and may specify a location 
within the segment to which control is to 
be transferred. 


Table 14 defines of the 


Load End card fields. 


the contents 


Table 14. Load End Card 


T 
| Column 


_E 
| 
| 
| 
| 
| 


identification 
Identifies this as a 


_ 


card acceptable to the loader. 


END. Identifies 


load card. 


the type of 


Blank. 


Address 
extended 
point in the program segment to 


| 

+ 

| 

| 

| 

| 

| 

| 

| 

| 

| (may be blank), in 
: 
| which control may be trans- 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
[ 
| 


card code, of the 


| 

| 

| 

| 

| 

| 

| 

| 

[ 

| 

| 

| 
ferred at the end of the load- | 
ing process. See the condi- | 
tions and priority discussed | 
under Load Terminate card. | 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

J 


9-14 Blank. 


15-16 External Symbol Identification 
(ESID) . 


17-72 Blank. 


73-80 Not used by the loader. The 
programmer may leave blank or 
punch in program identification 
for his own convenience. 
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LOAD TERMINATE CARD 


The Load Terminate card (LDT) must be 
placed at the end of the program segment. 
It has two uses: 


1. It is needed to end the loading proc- 
ess. 


2. ‘It causes control to be transferred to 


some location within the segments 
loaded. 
The specific location to which control 


is transferred is determined through the 
following order of priority: 


1.2 Control is always transferred toa 
location specified in a Load Terminate 
card. 


2. If the Load Terminate card does not 
specify a location, control is trans- 
ferred to the location specified by 
the first Load End card encountered 
during the current loading process. 


3. If neither the Load Terminate card nor 
any of the Load End cards specifies a 
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location, control is transferred to 
the first location loaded into from a 
TXT card (or REP card, if there are no 
Text cards), above 127 decimal or 7F 
hexadecimal, of the first program seg- 
ment loaded. 


When control is transferred to the 
segment (Ss) loaded, the system operates in 
the Supervisor state, disabled for alli 
interruptions except a machine check inter- 
rupt; see "Input/Output Support Package" 
for a discussion of interruptions. 


program 


Figure 2 shows a possible sequence of 
cards, in a series of program segments, 
ready to be loaded by the relocating load- 
er; it does not show all permissible combi- 
nations of load cards. (The figure reads 
from the bottom.) 


OTHER FEATURES 


In addition to the 
basic functions, it 
other operations: 


relocating loader's 
can be used for two 


1. To implement a technique that allows 
execution of programs larger than 
available ‘storage, that is, an over- 
laying load procedure. . 
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2. TO operate in the 
absolute loader. 


same way as the 


A description of these operations follows. 


Table 15 defines the contents of the 
Load Terminate card fields. 
Table 15. Load Terminate Card 
iano Ta i gt mag ee eo ee Se 1 
| Column | Contents | 
a Sg aa TRU RR 1 
| 1 | Load card identification | 
| | (12-2-9). Identifies this as a | 
| {| card acceptable to the loader. | 
| | | 
| 2-4 | LDT. Identifies the type of | 
| | load card. | 
| | | 
{ 5-16 | Blank. | 
| | | 
} 17-22 | Name of entry point to the | 
| | program segment, left-justified | 
| | in these columns. Use of this | 
| | field is optional. | 
| | | 
| 23-72 | Blank. | 
| | | 
| 73-80 | Not used by the loader. The | 
| | programmer may leave blank or | 
| | punch in program identification | 
| | for his own convenience. | 
Bee ee Ps a ee 
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--If the 


are executed. 


5 


-~Causes 


which 
can overrule here.) 


by 
5 


wT 


--Defines external 


refers. 


ESD (Type 2) 


ESD (Type 0) 


6 


E 
| transferred after loading 
overrule) . 
(a --Provides information to 
addresses in Segment A. 
REP 
format. 
TXT --Segment A's instructions and constants. 
ESD (Type 2) 
refers. 
ESD (Type 1) --Defines 
refer. 
( ESD (Type 0) --Defines name and length of Segment A. 
Ics --Defines program Segment B 
specifies length to be reserved for it. 
pale 


Figure 2. 


overlaying load procedure is 
segments may be loaded after the preceding program segments 


loading process 
address for transfer of control, this 
saved or specified by an END card. 


--If program segment A's END card does not specify an address to 

control is transferred, this card may do so. 

-~-Provides information to loader for 
addresses in Segment B. 

--Segment B's instructions and constants. 


symbol 


--Defines name and length of Segment B. 


--May list an address within Segment A to which control will be 


--Causes changes or additions to be made to Segment A's internal 


--Defines the name of Segment B as a symbol to which Segment A 


entry point in Segment A to which other segments may 


--Sets location counter at an absolute or symbolic address. 


used, other program 


to end. If this card specifies an 


overrules any address 


(LDT also 
evaluating relocatable 
in Segment A to which Segment B 

(conditional; LDT card can 


loader for evaluating relocatable 


aS a segment to be loaded and 
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Two Program Segments Ready for Loading by Relocating Loader 


(This figure reads from bottom to top.) 


OVERLAYING LOAD PROCEDURE 


The overlaying load procedure allows the 
programmer to execute programs larger than 
available storage. The general principle 
is that once a loaded program segment is no 
longer needed, another program segment may 
be loaded over it. The process of overlay- 


ing the segments no longer needed with 
another program segment is continued until 
all the program segments are executed. 


More specifically, the first segments 
are loaded in the usual manner. The load- 
ing procedure would then be interrupted by 
an LDT card which would transfer control to 
one of the loaded segments. When the 
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loaded segment has completed its opera-~ 
tions, the program segment would transfer 
control back to the loader to load the next 
program segment. The considerations for 
doing this are described in the next para- 
graph. 


The relocating loader defines, as a 
builtin _entry—point, _ajocation named 
RESUME. If the loader is entered at this 
jocation, loading will resume at the loca- 
tion specified in LOCCT, which has not been 
reset or changed after loading the previous 
segment; the programmer can reset LOCCT by 
an SLC card. 


The relocating loader may be entered at 
RESUME by the following coding sequence in 
the program segment: 


EXTRN RESUME Define RESUME to 


the segment 


L 1,RESADD Load address of 
RESUME 


BCR 15,1 Branch to RESUME 


Define address of 
RESUME 


RESADD DC A (RESUME) 


If the first card the loader encounters 
is an SLC card which sets LOCCT to the same 
starting address the previous program seg- 
ment had occupied, the previous segment 
will be overlaid. Consider the following 
example: 


A user has a 16K machine. 
records that show: 


He has inventory 


1. Quantity on hand at the beginning of 


the month. 

2- The number of items sold during the 
month. 

3. The number of items purchased during 


the month. 
4. The minimum re-order figure. 


These inventory records occupy 4000 bytes 
of storage. 


He haS a program segment-.to perform each 
of the following operations: 


1. Subtract the number of items sold from 


22 


the quantity on hand at the pest nnsng 
of the month; program segment J. 


2. Add the number of items 


program segment K. 


purchased; 


3. Compare the items on hand to the 
minimum re-order figure and move those 
items which must be re-ordered to an 
output buffer area; program segment L. 


4. Print a list of the current inventory 
on hand; program segment M. 


5. Print a list of the items to be 


re-ordered; program segment N. 


Each of these five program segments 
occupies 1500 bytes of storage and the 
output buffer occupies 250 bytes of stor- 
age. Finally, the relocating loader occu- 
pies 3800 bytes of storage and the user's 
I/O routines occupy 1000 bytes of storage. 


Since the entire program is larger than 
available storage, the programmer uses the 
overlaying load procedure as follows: 


1. He loads the loader, the list of his 
inventory, and the first program seg- 
ment. He then interrupts the loading 
procedure with a Load Terminate card, 
which transfers control to one of the 
loaded segments; in this case, program 
segment J, and execution proceeds 
until all the inventory categories 
have been processed by this program 
segment. 


2. Program segment J then transfers con- 
trol to location RESUME, and the next 
program segment -- program segment K 
-- is loaded. The first card in 
program segment K is an SLC card which 
uses the name of program segment J as 
the address to which the location 
counter is to be set. Thus, program 
segment K would overlay program seg- 
ment J. In this illustration, the 
second program segment would overlay 
the first, which is no longer needed. 


3. Control is again transferred to one of 
the program segments by interrupting 
the loading procedure with a Load 
Terminate card, and execution pro- 

7? ceeds. the program segments he no 
onger needs with another program seg- 
ment until the lists of inventory on 


hand and items to be re-ordered are 
printed (always making sure that he 
does not attempt to overlay the loader 
or the other segments) . 


LOADING IN ABSOLUTE FORM 


The relocating loader operates in a 
Manner similar to the absolute loader, if 
the External Symbol Dictionary card (ESD 
type 0) is removed from the program segment 
before load time. 


Note: The loader will not record in the 
Reference Table the presence of a program 
segment loaded in absolute form. The load- 
er loads one or more segments in absolute 
form until it encounters a Load Terminate 
card. (Load End card will not terminate 
loading.) It also loads program segments in 
both absolute form (without ESD type 0 
cards) and in relocatable form. However, 
the following limitations apply to this 
situation: 


1. No linkage is provided with any pro- 
gram segment loaded in absolute form. 
If the programmer wishes to load at 
the locations assigned by the assem- 
bler with linkage to another segment, 
he must specify the starting address 
with a Set Location Counter card and 
must not remove the ESD type 0 card. 


2. If two or more program segments are 


loaded in absolute form, one will 
overlay the other at all common 
addresses. 


LOADER USE OF I/O SUPPORT PACKAGE 


The relocating. loader uses selected 
modules of the I/O Support Package to read 
cards or card images from tape and, if a 
writing device (typewriter or printer) is 
indicated to the loader, storage mapping 
and error messages will also be written. 
These routines can be used by the program- 
mer by employing the coding sequence (with 
absolute addresses) ‘discussed . in 
"Input/Output Support Package." 


RESIDENT LOADER CONSIDERATIONS 


The name of the first instruction in the 
relocating loader is: LOAD2. If this loca- 
tion is branched to (either from the con- 
sole or from a program segment in storage 
that defines LOAD2 as an EXTRN), another 
program segment can be loaded without 
preceding it with another relocating load- 
er. 


CAUTION: The user cannot use LOAD2 for an 
overlaying load procedure, since the Ref- 
erence Table is destroyed whenever LOAD2 is 
branched to. 


See appendixes for further information 


about relocation and linkage, and the crea- 
tion of self-loading loaders. 
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DUMP PROGRAM 


INTRODUCTION 


The dump program is designed to provide 
a listing of the contents of all or part of 
storage, the general registers, and the 
floating-point registers (or any combina- 
tion of these). To be more specific, at 
the option of the user, the dump program 
can produce a listing of any or all of the 
following: 


1. Console listing; that is, a listing of 
storage locations from zero through 
127. This listing includes: 


a. Initial Program Loading PSW: 
locations 0-7 


b. Initial Program Loading CCW1: 
locations 8-15 


c. Initial Program Loading CCW2: 
locations 16-23 


ad. External Old PSW: locations 24-31 


e. Supervisor Call Old PSW: 
locations 32-39 


£f. Program Old PSW: locations 40-47 


g.- Machine check old PSW: 
locations 48-55 


h. Input/output Old PSW 
locations 56-63 


i. CSW: locations 64-71 

j- CAW: locations 72-75 

k. Unused word: locations 76-79 

1. Timer: locations 80-83 

m. Unused word: locations 84-87 

n. External New PSW: locations 88-95 
Oo. Supervisor call new PSW 936-103 

p.- Program New PSW: 104-111 


q. Machine Check New PSW: 
locations 112-119 


r. Input/output New PSW: 
locations 120-127 


2. The sixteen general registers. 
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3. The four floating-point registers.1 
4. All or part of storage. 
The listing is printed on the IBM 1403 


or 1443 Printer or on the IBM 1052 Printer- 
Keyboard. 


FEATURES 


The 
features: 


dump program has the following 


1. Listings may be taken at any point 
during execution of the user's pro- 
gram. 


2. The user may choose any of eight basic 
formats for the listing and may 
include several storage areas in dif- 
ferent formats within the same list- 
ing. 


3. Lengths of the areas to be listed, 
and, with two of the output formats, 
the length of the items within the 
area, may be specified. 


4. Request numbering allows the user to 
provide for several listings in his 
source program, but to call for only 
those listings needed during a parti- 
cular run. 


5. Each storage area listed may be 
assigned an identifying label of eight 


characters, which will immediately 
precede the listing of the storage 
area. 


VERSIONS OF THE DUMP PROGRAM 


There are two versions 
program: the single-phase version anda 
two-phase version. (See the "Introduction" 
to this manual for an approximation of the 
storage required for each of the versions 
of the dump program.) The single-phase 
version is available as follows: 


of the dump 


‘If the floating-point 
requested on a machine without the 
floating-point feature, a program error 
wait will occur and the program will not 
continue. 


registers are 


1. A symbolic deck that may be assembled 
by the user at the locations he 
desires and loaded by either the abso- 
lute or relocating loader; this deck 
provides all the facilities listed in 
"Features." 


2. An assembled deck that may be loaded 
by either the absolute or relocating 
loader; this version provides all the 
facilities listed in "Features." 


3. A self-loading deck which is assembled 
beginning at Location 128 decimal; it 
provides hexadecimal listings only. 
This deck provides the user with the 
advantage of dumping storage when his 
program has come to an unexpected 
stop. It also allows the user to dump 
the contents of storage after execu- 
tion of his program. 


The two-phase version is 
follows: 


supplied as 


1. Phase 1 of the Two Phase Dump is 
available as (a) a symbolic deck that 
must be assembled and (b) an assembled 
deck that may be loaded by either the 
absolute or relocating loader. 


2. Phase 2 is available as (a) a symbolic 
deck that must be assembled and (b) as 
a self~loading deck. 


Each of the phases is loaded and execut- 
ed separately. 


Thus, this version provides the advan- 
tage of conserving storage, since only 
Phase 1 is resident during execution of the 
user's program. 


The single-phase version program is dis- 
cussed in the body of this section. The 
two-phase version is discussed in 
“Two-Phase Dump," and the self-loading 
version of the dump program is discussed in 
"Self-Loading Dump Program." 


REQUEST NUMBERS 


Two bytes of storage, beginning at sym- 
bolic location RTBL, are used by the dump 


program as binary switches indicating the 
Status of request numbers. The 16 bit 
positions, beginning with zero in the high- 


order position, correspond to the 16 
possible request numbers -- 0 through F. 
The presence of a bit indicates that a 


storage print is to be executed if the 
user"s call parameter includes a request 
number corresponding to the position of 
that bit. After assembly, the programmer 
inserts the desired mask into RTBL by a 
Replace card.1 Prior to assembly, he may 
set the mask in the symbolic deck. 


These two bytes are originally defined 
as DC xX*'8000'. This indicates that a 
request specification of zero will result 
in the execution of a storage print, while 
the specification of any other request 
number will cause immediate return to the 
user's program. 


Table 16 defines the fields of a Replace 
card used for request numbers. 


Example - 


Symbolic locations RTBL and RTBL+1, as 
originally assembled by DC X‘'8000', may be 
illustrated as follows: 


Symbolic Symbolic 

Location Location 

RTBL RTBL+1 

¢ t 
Bit 11 0000000000000 0 0] 
Request Oo 123 456789 ABCODE F| 
Number t____—__-___-__— ~~~ + — —— ——-—— - 


Pe Ne SRE AE A OC LS SS DE ONSITE 


4 The programmer must refer to his listing 
and place the absolute address assigned to 
symbolic location RTBL in card columns 7-12 
of the Replace card. He will find this 
location near the end of his listing. 
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Table 16. Format of Replace Card for 


Request Numbers 
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Column | Contents 


H Load card identification 
(12-2-9 punch). Identifies 
this as a card acceptable to 
the loader. 


REP. Identifies 
load card. 


the type of 


Blank. 


Starting absolute address in 
hexadecimal as assigned by the 
assembler to symbolic location 
RTBL. The programmer must 
refer to the assembly listing 
to get this absolute address. 
It must be right-justified in 
these columns, and unused lead- 
ing columns filled in with 
zeros. 


13-14 Blank. 


15-16 External Symbol Identification 
(ESID 01). Hexadecimal number 
assigned to the program segment 
in which the replacement is to 
be made. 

17-20 One four-digit hexadecimal 
field indicating which of the 
bit positions in symbolic loca- 
tion RTBL and RTBL plus 1 are 
to be set to a binary one. 


21-72 Blank. 


73-80 Not used by the loader. The 
programmer may leave blank or 
punch in program identification 
for his own convenience. 


i a i i a a 
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Assume that the programmer finds the 
absolute address, as assigned by the assem- 
bler to symbolic location RTBL, to bea 
hexadecimal 1388 (5000 decimal); also 
assume that the request numbers that he 
wishes are 3, 6, 9, and C. 


The programmer punches a hexadecimal 
001388 in card columns 7-12 of the Replace 
card. In columns 17-20, he punches a 
hexadecimal 1248. After the Replace card 
has been loaded, the bit positions in 
hexadecimal locations 1388 and 1389 are: 
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1388 1389 
4 4 
Pose ee ee ee ea ee 1 
Bit 1900100100170 01700 0 
Request lO 123 456789 ABCDEFP 
Number ooo 4 
Now if the user's call parameter 


includes a request number corresponding to 
a bit that is on (i.e., 3, 6, 9, or C), a 
storage print will be taken. 


DUMP PROGRAM REQUIREMENTS 


SINGLE-PHASE 


If the single-phase dump program is 
being used, the user supplies (by symbolic 
cards prior to assembly or by a Replace 
card at object time) the following informa- 
tion to the dump program: 


1. The storage 
machine. 


capacity of the user's 


2. The type of output device to be used. 


3. The address of the output device. 


4. The address of the IBM 1052 Printer- 
Keyboard (if one is available for 
operator messages) . 


The storage capacity of the user's 
Machine is supplied to the dump program by 
locating the following card in the dump 
source program?: 

DSTOPL DC AL3 (8192) 

The user takes this card out, and if the 
operand field does not specify his storage 
capacity, he must punch a copy of this card 
(in decimal notation) with the storage 
capacity of his machine in the operand 
field, and put it back into the dump source 
program. 


The type of output device that is to be 
used and its address are supplied to the 
dump program by locating the following card 
in the dump source program: 


OUTDEV DC X"zzzzzzzz* 


tNote: This and subsequent cards come 
immediately before the END card in the dump 
source program. Their relative order can- 
not be altered. 





In the low-order two bytes of the oper- 
and field, he must punch the address of the 
output device; in the high-order two bytes, 
if the output device is to be the IBM 1403 


or 1443 Printer, he punches 0000. For 
example: 
OUTDEV DC X*OOOO0Addr ‘ 


If it is the IBM 1052 Printer-Keyboard, he 
punches 0001. For example: 


OUTDEV DC X*0001Addr' 


The user then locates the following card 
in the dump source program: 

TYPWTR DC x" 22zz2" 

If there is an IBM 1052 Printer-Keyboard 
available for operator messages, he punches 
its address in the operand field; if there 
is none, he should punch in the address of 
another printer. If there is neither, he 
punches this card as follows: 

TYPWIR DC X'FFFF' 

The user then puts the card back into the 
dump source program. 


Placing hexadecimal F's in TYPWTR only 
disables Dump Program operator messages, 


not those of the I/O routines. There are 
two methods to disable I/O messages. They 
are as follows: 

1. Prior to assembly remove the “Write 


Error Message Base Routine," from the 
I/O portion of the program. 


2. At object time, use a Replace card to 
change the instruction at SAGINW+t4 (in 
the I/O Base Routine - Group 1, Inter- 


rogate I/O Interrupt or CC1) back to 
the same format it had on the assembly 
listing. 

Example 


A user has a machine with a_ storage 
capacity of 65,536 bytes. He is going to 
make his listings on the IBM 1403 Printer, 
which is unit 9 on selector channel 1. He 
wants his messages written on the IBM 1052 
Printer-Keyboard, which is unit 5 on multi- 
plexor channel 0. He would punch the cards 
as follows: 


DSTOPL DC AL3 (65536) 
OUTDEV DC X'00000109" 
TYPWIR DC X*0005° 


CALLING SEQUENCE 


When the dump program and the user's 
program are assenbled together, the user 
calls the dump program with the following 
sequence of coding: 


LA 15, DUMP 
BALR 14,15 


and follows these instructions with the 
appropriate DC assembler instructions set- 
ting up the call parameter for the listing. 


Note: When the dump program and the user's 
program are assembled separately and the 
relocating loader is being used, the pro- 
grammer must define the dump program as an 
external symbol: 


EXTRN DUMP 


and he can call it by: 


L 15, ADDUMP 
BALR 14,15 


after having generated an address: 


ADDUMP DC A (DUMP) 
The rest of the discussion on the calling 
sequence applies to both loaders. 


Control returns to the user's program at 
the location immediately following the call 
parameter. The call parameter is one half- 
word if a print of storage is not desired, 
and three half-words, if a print of storage 
is desired. The call parameter specifies 
the following basic conditions for the 
listing: 


1. The request number of the listing. 


2. The options (see the "Introduction" to 
this section for a list of options) 
Which the listing will include. 


If the listing is to include storage, 
the number of Control List (see "Control 
List Format") entries and the address of 
the first entry must be specified. If ail 
of storage is to be listed in 32-bit 
hexadecimal, the Count field of the call 
parameter may contain zero, and the Address 
field will then be ignored (but must not be 
omitted). 


Note: Except for symbolic references, the 
variable fields of the DC instructions 
which set up the Call Parameter and Control 
List are usually coded in hexadecimal. 


Table 17 shows the format of the 
parameter. 


call 
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Table 17. Call Parameter Format 


1 2 3 8 9 12 13 16 17 24 25 48 
Te ee a eae ete Mp ae ee a en re re ea 
{ Length of | | Request | | | 
| Parameter | Not Used | Option Number | Count | Address | 
a i a ff 

00 
or 
11 


Address of first entry 
in the control list 


oS 
oO 
- 
ond 


| | 
| | 
| | 
| | 
(0-F) | | 
| | 
| | 
{ | 


ee 


| 
| 
| 
| 
| 
| 
| 
| 
L 


ce nee mane sen aacitr pene eon enn wean aon onsen enn asertee oes caw cam renoe as amvamw ame le eave wun ant ene amen ene eam ase les cee a ere are ene eam ee waa lee wen eae eae ae en een a en te ee ee ee a ne 


Feuer ee ge Yad Wee does oie Re ome Ce Aye I ints we ayy Sipe w ige WOON g en a ews ew Re ete NY, arf ego pee yo 


| Bit | | | Hexadecimal 
| Positions | Field Name { Significance | Coding 
po—-—-——--} ~~ = fn nn na fn 
1-2 Length of 00 indicates a half-word parameter and 00 
parameter that no storage is to be dumped. or 

co 

11 indicates a three half-word parameter 
and that at least one area of storage is 
to be dumped. 


W 
' 
[o< 


Not used. 


9-12 Option 0000 indicates no options are exercised. 

0001 print general registers. 

0010 print floating-point registers. 

0011 print floating-point and general 
registers. 


0100 print console listing. 


= WN = © 


0101 print console listing and general 
registers. 

0110 print console listing and floating- 
point registers. 

0111 print all options. 


~~! oO wi 


13-16 0 
through 


F 


A four-bit hexadecimal number from 0 
through F. If the corresponding RTBL bit 
is a one, the listing is provided; other- 
wise, control returns immediately to the 
user's program. 


Request Number 


17-24 00 
through 


FF 


Count An eight-bit number (when symbolic address 
constants are used to designate addresses, 
this number is limited by the maximum 
number of address constants allowed by the 
Basic Assembler) which is the total number 
of entries in the Control List. If this 
number is 0, all of storage is printed in 
32-bit hexadecimal format and the Address 
field of the call parameter is ignored (but 
it may not be omitted). 

25-48 Address The 24-bit address of the first entry in If absolute 
the Control List. If symbolic, it is coded a 1 to 6 


| separately as: DC AL3 (symbol). digit number | 


ree metas es ec te ar ie een Mi a a i ee eh eed 


ee ASD AS SS SN SS SOU ce NNN SRR NE NE SERED SS SD SON MY PN NS ae SA END GD vO ES UE SED ts ca aa MS em ce GENS SE aD ms ee nf 


cr ee eee ee a ee ere eee eee ee cme sees SS eS ee a SS SS ES ES ST ES TE NS AE SS SN SRI AOS MLE SE SEED NOS SD SE AED ce So 
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Examples of the required call-parameter 
coding follow. (Each example assumes’ that 
the corresponding request number has been 


specified.) 
Example 1 
LA 15, DUMP 
BALR 14,15 
DUMP1 pc X'0034' 
where: 


00 indicates a half-word call parameter 
and that no storage is to be dumped. 


3 indicates that the floating-point and 
general registers are to be dumped. 


4 is the request number. 


In this example, the general and 
floating-point registers are listed, and 
control returns to DUMP1 + 2. 

Example 2 
LA 15, DUMP 
BALR 14,15 

DUMP2 Dc X*C00000000000' 

where: 


COQ indicates a three half-word call param- 
eter and that at least one area of 
storage is to be dumped. 


0 Since the count field is 
options are to be exercised. 


zero, no 


0 is the request number. 


00 is the control list entry, so all of 
storage will be listed in 32-bit hexa- 
decimal format. Control returns to 
location DUMP2 + 6. 


000000 is the address field. Since the 
count field is 0, this field is ignored 
but may not be omitted. 


Example 3 
LA 15,DUMP 
BALR 14,15 
DUMP3 pc X*CO1A04' 
pc AL3 (LIST) 


where: 


CO indicates a three half-word call param- 
eter and that at least one area of 
storage is to be dumped. 


1 indicates that the general 
are to be printed. 


registers 


A is the request number. 
O04 is the number of Control List entries. 
LIST 


is the address of the first Control 
List entry. 


The general storage registers and the 
four storage areas specified by the Control 
List entries beginning at location LIST are 
to be dumped. Control returns to location 
DUMP3 + 6. 


CONTROL LIST FORMAT 


The Control List consists of a maximum 


of 255 entries. Each entry specifies the 
following: 
1. An area of storage to be listed. 
2. How it is to be listed: in what 
format it is to be listed and the 


length in bytes of each item to be 
listed (where not implied by the 
format) . 


3. The address of the first byte of the 
area to be listed. 


4. Whether the End Flag field specifies 
an end address plus 1 location or a 
count of bytes. 


5. Whether or not there is a dump iden- 
tification label. 


6. The size of the area is defined in the 
End/Count field of the Control List 
entry either by the address of the 
last byte plus 1 or by the number of 
bytes in the area. 


If the programmer assigns an identifying 
eight-byte label to an area, he places the 
label as the second double-word of the 
Control List entry. When printed, the 
label precedes the listed area. 


Table 18 shows the format of the Control 
List Entry. 
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Table 18. Control List Entry Format 


1 2 3 4 5 8 9 32 33 4O 41 64 65 128 
nancies ee ener pie a nn ee er es 
|Label|End |Not |Format | | | | | 
[Flag |Flag |Used| Code |Starting Address| Length | End/Count | Label | 
——---}----- }-—- f ------- | ------—----—- f -—----- f --- ~~ ------- f------------4 
{| oO | Oo | | (O-A) jAddress of first| (01-10) |jEither an End JOptional eight- | 
{| or | or | | *6/byte of the area| 46|Address +1 Location, |byte label | 
{i 14 | 17 | | |to be listed | Jor a count in bytes | (2 words) | 
| | | | | | jof the area to be | | 
| | | | | | jlisted (see “End | | 
| | | | | | |Flag") . | | 
ice a a a a cl ah cs tei a a eae ate 
Ce re gy ele ony ee ee ge Oe een a eae Tg ey Bee ae ee 
| Bit | | ene | 
| Positions | Field Name | Significance | 
{-—-—--———-- }--- -——-—_----—— {—------——__---—--—---~--§ —-----------—-----—- { 
{ 1 | Label flag | 0O indicates that no label is associated with the | 
| | [| area. | | | 
| | | | 
| | | 1 indicates that there is a label associated with | 
| | {| the area. | 
| | | | 
{ 2 {| End flag | 0O indicates that the End/Count field is interpreted | 
| | | as a Count. | 
| { | | 
| | | 1 indicates the End/Count field is interpreted as an | 
| | | end address plus 1. | 
| | { | 
{| 3-4 | | Not used. | 
| | | | 
| 5-8 | Format code | <A four-bit hexadecimal number, zero through A, | 
| | | specifying the list format (see “Output Formats") . | 
| | | | 
| 9-32 | Starting Address | The 24-bit address of the first byte of the area to | 
| | | be listed. The area must be properly aligned on a | 
| | | half-word, full-word, or double-word boundary, | 
| | | according to the format requested. If symbolic, it | 
| | | is coded separately as: AL3 (symbol). | 
| | | | 
| 33-40 | Length | An eight-bit number -- 1 through 16 -- specifying | 
| | | the length in bytes of each item. Used only with | 
| | | items of variable length having format codes of | 
| | | 0, 1, 2, or 3. If not used, it may be coded as: 00. | 
| | | | 
| 41-64 | End/Count | If the End flag is zero, this is the number of bytes | 
| | { to be listed, right-justified. | 
| | | | 
| | | If the End flag is one, this is a 24-bit address of | 
| | | the end of the area plus 1 that is to be listed. If | 
| | | symbolic, it is coded separately as: AL3 (symbol). | 
| | | | 
{| 65-128 | Label | An optional eight-byte label (if less than eight | 
{ | | characters, blanks must be included), present only | 
| | | when the Label flag is one. | 
Uc I ahs a i a ee ee ee oe ee 
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Examples of the required coding follow. 


LIST Dc x'cs8* Label flag; end 


flag; format 8 


DC AL3 (START Starting address 
Dc x'00° : Length field is 
ignored (because 
format 8 
is specified) 
DC AL3 (END+1) End address + 1 
DC C*COREDUMP* Label field 
pc X'88° Label flag; 
Count; format 8 
DC AL3 (SINE) Starting address 
pc x*'00000200" Length field is 
ignored (because 
format 8 is 
specified) ; Count 
DC C'SINEDUMP* Label field 
DC X*42"* No label flag; 
end flag; 
format 2 


DC AL3 (DATA) Starting address 
pc xX"10° Length field of 16 
DC AL3 (DATA+400) End address + 1 


The three list entries above would pro- 
duce listings of the following: 


1. The label COREDUMP, followed by the 
area from START through END, in hexa- 
decimal half-words with mnemonics. 


2. The label SINEDUMP, followed by the 
512 bytes starting at SINE, in hexa- 
decimal half-words with mnemonics. 


3. The area from DATA through DATA+399, 
in hexadecimal, each item 16 bytes 
long. 


OUTPUT FORMATS 


Listings produced by the dump program 
contain as many complete items per line as 
the length of the item permits. In the 
case of format types 0, 1, 2, and 3 (shown 
in Table 19), the length of an item is 
defined by the Length field (bit positions 
33-40) of the Control List Entry; in the 
case of types 4 through A, it is implied by 
the format. 

The dump program has one error message 
intended for the use of the programmer. 
This error message, which may be produced 
by either the single-phase dump or Phase 2 
of the two-phase dump, will appear on the 
listing as follows: 


DCI Control List Error... 
This Request Skipped 


Table 19. Output Formats 


+ 

Code _ | Format | 
~-~~-~-}—~----~----------------—--------J 
0 or 2| Hexadecimal. Each byte is 
decoded to two hexadecimal 
digits. Length is as_ speci- 
fied in the Length field. 


Each byte is printed as an. 
alphabetic or zoned decimal 
character. Length is as spec- 
ified in the Length field. 


1 or 3 


Hexadecimal half-word with 
mnemonics. Each half-word is 
decoded to four hexadecimal 
digits, and interpreted mne- 
monic operation codes appear 
beneath each instruction. 


+ 
ie) 
kK 
co 


NOTE: Data whose bit configu- 
ration coincides with that of 
an operation code is also 
accompanied by a mnemonic. If 
a bit combination which does 
not represent a valid mnemonic 
is encountered, an xX will 
appear below the high-order 
digit of the address in the 
left-hand margin. 


Hexadecimal full-words without 
mnemonics. Length of each 
item is four bytes. 


Short~-precision floating-point 
decimal. Each full-word of 
binary data is converted to 
eight decimal digits, with 
sign and exponent. Negative 
numbers appear in true form. 


Long~-precision floating-point 
decimal. Each double-word of 
binary data is converted to 17 
decimal digits, with sign and 
exponent. Negative numbers 
appear in true form. 


Half-word fixed-point decimal. 
Each half-word of binary data 
is converted to decimal with a 
sign. Negative numbers appear 
in true form. 


Full-word fixed-point decimal. 
Each word of data is converted 
to decimal with a sign. Nega- 
tive numbers appear in true 
form. 


a Re AOE eS A A SS aS 


es a a a a a a ce ee es Se 


This message will occur whenever an invalid 
condition is encountered in the Control 
List Entry. The error may be caused by a 
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Call Parameter which does not contain a 


valid Control List Address. 


Finally, when the floating-point formats 
are used, the printed fraction will not 
differ by more than one in the low-order 
position from the exact decimal representa- 
tion rounded to eight (short-precision) or 
17 (long-precision) places. 


Table 19 shows the output formats of the 
dump program. See Figure 3 for a sample 


listing of each of the output formats. 
(Note: When a format that prints mnemonics 


is being used, the user may find the 
character X beneath the high-order digit of 
the location specifier and on the same line 
as the mnemonics. If this occurs, it means 
that at least one invalid operation code 


was encountered on that line.) 


TWO*PHASE DUMP 


As mentioned in "Versions of the Dump 
Program," the dump program is also availa- 
ble in a two-phase version. These phases 
are loaded and executed separately to con- 
serve main storage; the first phase pro- 
duces nonedited data which is used by the 
second phase to produce listings in the 
same formats that the single-phase opera- 
tion does; calling sequence and parameter 
formats are the same as in the single-phase 
operation. 


The user supplies certain information to 
the two-phase dump program as he had to do 
in the single phase dump program. There- 
fore the user supplies Phase 1 (in the 
source program or by a Replace card at 
object time) with the following informa- 
tion: 


1. The storage capacity of his machine. 


2. The type of device to be used for 
output. 


3. The address of the output device. 


4. The address of the IBM 1052 Printer- 
Keyboard (if one is available for 
operator messages) . 


The storage 
Phase 1 source 
following card’: 


capacity is provided to 
program by locating the 


*Note: The cards to be punched for Phase 1 
come immediately before the END card in the 
Phase 1 source deck. Their relative order 
cannot be altered. 
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- 0001. 


DSTOPL DC AL3 (8192) 

The user takes this card out, and if the 
operand field does not specify his ‘storage 
capacity, he must punch a copy of this card 
(in decimal notation) with the storage 
capacity of his machine in the operand 
field, and put it back into the Phase 1 
source deck. 


The type of output device that is to be 
used and its address are supplied to the 
Phase 1 source program by locating the 
following card: 

OUTDEV DC X"Zzzzzzzz*" 

In the low-order two bytes of the 
operand field, he must punch the address of 
the output device; in the high-order two 
bytes, if the output device is to be tape 
unit, the user punches 0000. For example: 

OUTDEV DC X*"0000Addr' 

If the output device is to be the IBM 
2540 Card Reader-Punch, the user punches 
For example: 
OUTDEV DC X*0001Addr' 

If the output device is to be the IBM 
1442 Card Reader-Punch, the user punches 
0002. For example: 

OUTDEV DC X'0002Addr'° 
The user then locates the following card in 
the Phase 1 dump source program: 

TYPWTR DC X*zzzz* 

If there is an IBM 1052 Printer-Keyboard 
available for operator messages, he punches 
its address in the operand field; if there 
is none available, he should punch in the 
address of another printer. If neither are 
available, he punches it as follows: 

TYPWTR DC X'FFFF' 


The user then puts the cards back into the 
Phase 1 source deck. 


Placing hexadecimal F's in TYPWTR only 
disables Dump Program operator messages, 
not those of the I/O routines. There are 


two methods to disable I/O messages. They 
are as follows: 
1. Prior to assembly, remove the "Write 


Error Message Base Routine" from the 
I/O portion of the program. 


2. At object time, use a Replace card to 
change the instruction at SAGINW+t+4 (in 
the I/O Base Routine ~ Group 1, Inter- 
rogate [I/O Interrupt or CC 1) back to 


the same format it had on the assembly 
listing. 


If using the Phase 2 source program, the 
user must supply (by symbolic changes to 
the source program or by a Replace card to 
the assembled relocatable deck at object 
time) the following: 


1. The type of output device to be used 
and its address. 


2. The type of input device to be used 
and its address. 


3. The address of the typewriter (if one 
is available). 


The type of output device that is to be 
used and its address are supplied to Phase 
2 by locating the following card in the 
Phase 2 source program?*: 

OUTDEV DC X'zzzzzzzz* 

In the low-order two bytes of the oper- 
and field, he must punch the address of the 
output device; in the high-order two bytes, 
if the output is to be printed on the IBM 
1403 or 1443 Printer, the user punches 
0000. For example: 

OUTDEV DC X*OQ0OO00Addr* 


If the output is to be written on the 
IBM 1052 Printer-Keyboard, the user punches 


0001. For example: 
OUTDEV DC X‘'0001Addr'° 
The input device to be used and its 


address are supplied to Phase 2 by locating 


the following card in the Phase 2 source 
program: 

INDEV pc X'zzzzzzzz' 

In the low-order two bytes, he must 


punch the address of the input device; in 
the high-order two bytes, if the input is 
to come from tape, the user punches 0000. 
For example: 

INDEV Dc X*Q000Addr* 

If the input is to come from cards, the 
user punches 0001. For example: 

INDEV DC X'0001Addr* 


The user then locates the following card in 
the Phase 2 dump source program: 


A I ee A RE I at NE I SS ND a <O 


*Note: The cards to be punched for Phase 2 
come immediately before the END card in the 
Phase 2 source program. Their relative 
order cannot be altered. 





TYPWTR DC X'zz2z2" 


If there is an IBM 1052 Printer-Keyboard 
available for operator messages, he punches 
its address in the operand field; if there 
is none available, he should punch in the 
address of another available printer. If 


neither are available, he punches it as 
follows: 
TYPWTR DC X'FFFF' 


Placing hexadecimal F's in TYPWTR only 
disables Dump Program operator messages, 
not those of the I/O routines. There are 
two methods to disable I/O messages. They 
are as follows: 


1. Prior to assembly, remove the Write 
Error Message Base Routine from the 
I/O portion of the program. 


2- At object time use a Replace card to 
change the instruction at SAGINW+4 (in 
the I/O Base Routine - Group 1, Inter- 
rogate I/0 Interrupt or CC 1) back to 
the same format it had on the assembly 
listing. 


to use the _ self- 
loading version of Phase 2. (A Phase 2 
relocatable assembled deck can not be 
loaded by either the absolute or the relo- 
cating loader on an 8K machine) the follow- 
ing information must be supplied: 


If the user wishes 


1. The type of output device and iits 
address. 
2. The type of input device and its 


address. 


3. The address of the IBM 1052 Printer- 
Keyboard (if one is available for 
operator messages) . 


The user supplies this information by 
taking out the END card from the _ self- 
loading deck of Phase 2 of the Two-Phase 
Dump and punching this card as follows: 


Columns 17-20 The address of the output 


device, printer, or IBM 
1052 printer-Keyboard, that 
to be used. 

Column 21 0 if a printer is to be 
used, or 


1 if an IBM 1052 Printer- 
Keyboard is to be used. 


Columns 22-25 The address of the input 


device that is to be used. 


Column 26 0 if the input is to come 
from tape, or 
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1 if the input is to 
from cards. 


come 


The address of the IBM 1052 
Printer-Keyboard, if one is 


Columns 27-30 


available for operator 
messages. If none is 
available, he must punch it 
aS: FFFF. 


I/O error messages are only displayed on 
the console during error waits when the 
self-loading deck supplied by IBM is used. 


A user with a machine larger than 8K can 
make more efficient use of Phase 2 of the 
Two-Phase Dump by altering the source pro- 
gram for residence in higher storage and 
increasing the buffer size. (Both of the 
preceding are noted on the assembly list- 
ing.) The assembled deck can then be 
loaded by either the absolute or relocating 
loader. 


Phase 1is resident in storage during 
execution of the user‘s program. It occu- 
pies much less storage than the _ single- 


phase dump program and it may be called as 
often as necessary during the execution of 
the user's program. 


The output of Phase 1 is in Text (TXT) 


card format (formats of Text cards are 
discussed in the sections on both the 
absolute and relocating loaders); when 


Phase 2 is loaded at the termination of the 
job (or at the end of the day), all of 
storage is available for its use. 


1. Sequence 


ae Phase 1 dumps the contents of 
storage and/or ' registers, 
according to the options listed in 
the "Introduction," onto DMP and 
TXT cards, or aS card images on 


tape. Storage is dumped on loader 
TXT cards or as card images on 
tape. (The TXT cards produced by 
Phase 1 can be loaded by either 


the Absolute or Relocating Load- 
ers; thus, if the user programs a 
routine to reset the general reg- 
isters and locations 0-127, and 
the I/O devices are repositioned, 


a checkpoint procedure can be 
facilitated.) Phase 1 does not 
rewind tape. 

b. At the conclusion of the user's 


program or at the end of the day, 
Phase 2 is loaded. Phase 2 ini- 
tially rewinds tape. It reads the 
output of Phase 1, and produces 
listings identical with those of 
the single-phase program. 
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2. phase 1 output 


a. DUMP (DMP) cards (or card images 
on tape) identified by a 12-3-9 
punch in card column one. These 
cards contain the call parameter, 


locations 0-127, and the contents 
of the general registers (and 
floating~point registers, if 


requested) . 


b. DUMP (DMP) cards for each entry in 
the Control List. 


c. TEXT (TXT) cards containing the 
data in all storage areas speci- 
fied in the Control List. These 
cards are identified by a 12-2-9 


punch in card column one. 


Note: Output from Phase 1 will go into 
stacker one on the 1442 Card Reader-punch 
and into the zero stacker on the punch side 
if the 2540 Card Reader-Punch is being 
used. These cards must be loaded in the 
same order that they were produced by Phase 
1. 


SELF-LOADING DUMP PROGRAM 


Both the single-phase dump program and 
the two-phase dump program are executed 
with the user's program. The self-loading 
deck may be executed if an unexpected stop 
occurs, It can be loaded directly into 
storage to dump the contents of storage. 
The self-loading deck is assembled begin- 
ning at location 128 decimal; since it is 
not loaded by the loaders, it cannot be 
altered or patched by a Replace’ card. It 
will provide a listing in full-word hexa- 
decimal format of the following: 


1. The console. 


2. The general registers. Only the con- 
tents of registers 0, 7, 9, 10, and 15 
remain intact after the loading proc- 
ess. 


3. The contents of storage from the first 
address after the location of the 
self-loading dump program through the 
full capacity of the user's machine. 


The user supplies the following to the 
self-loading dump program: 


1. The type of output device and its 
address. 


2. The storage capacity of his machine. 
3. The IBM 1052 Printer-Keyboard address 


(if one is available for operator 
messages) . 


The user supplies 
taking out the 


this information by 
END card from the self- 


loading deck and punching it as follows: 


Columns 17-20 


Column 21 


The address of the printer 


or IBM 1052 Printer- 
Keyboard that is to be 
used. 

0 if a printer is to be 
used, or 

1 if an IBM 1052 Printer- 


Keyboard is to be used. 


Columns 22-26 


Columns 27-30 


The storage capacity (in 
hexadecimal) of his 
machine, right-justified in 
these columns with a zero 
in the high-order column. 


The address of the IBM 1052 
Printer-Keyboard, if one is 
available for operator mes- 


sages. If none is avail- 
able, he must punch it as: 
FFFF. 
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LOC 0 0004000A00000600 LOC 8 0200060060000050 LOC 16 0200046020000050 


OLD PSWS 0106004000F 12345 OO0000035001 EF 84 0000000000000000 0000000000000000 8006000A0000000F Console Listing 
CSW OOOLEEE80C 000000 CAW OOOLEEEO 00000000 TIMER 00000000 00000054 
NEW PSWS O0O00DDD0000LED92 000400000001ED50 000400000001 EDDC 000400000001 ENDC OOOO0O0D000001EE6C 
FPR 0 2 1234967890123456? E O1 2 12345678901234567 E-01 © 12345678901234567 © 75 © 12345678901234567 E-77 Floating~Point 
Registers 
GPR O 0000000C LILLIA 22222222 33333333 44444444 55555555 66666666 T7TTT7TT77 General 
Registers 


GPR 8 ‘88888888 99999999 AAAAAAAA BBBBBBBB cccccccc DDDDDDUD EEEEEEEE FRFFFFEF 


COooLool 


000000 00 Ol 02 03 04 05 06 o7 08 09 OA OB oc OD JE OF 10 11 12 13 14 15 Hexadecimal , 


one-byte length 
000016 16 17 18 19 1A 1B ic 10 LE LF 20 2l 22 23 24 25 26 27 28 29 2A 2B 


CoooLoo2 
000032 ocol 0002 0003 0004 0005 0006 0007 0008 0009 OGOA 0008 000Cc 000D OOOE OOUF 0010 Hexadecimal, 


two-byte length 
000052 ooll 0012 0013 0014 0015 0016 0017 0018 0019 OOLA 0018 oo1c 001D OOlE OOLF 0020 


CCOO0L003 
000072 ooo0dl 000002 000003 000004 000005 000006 000007 000008 000009 Q0000A 000008 O0000C Hexadecimal, 
000096 000000 OOOOOE OOOO00F 000010 oooo8l o000l2 000013 000014 000015 000016 000017 000018 ae 
C005 


00011¢C 00000001 00000002 00000003 00000004 00000005 00000006 QQo00dcn0n7 00000008 00000009 O000000A Full-word 
unsigned 


000138 0000c00B 0000000C 0000000D OOOQOO000E OO00000F 00000010 oooocoll oGoUD0L2 00000013 00000014 hexadecimal 


coo1Lool 


000160 A B c C E F G H I J K L M N 0 P Q R S T U v Ww x Y Z A 6 Characters, 


one-byte length 
000188 Cc 1D} E F G H I J K L M N G P Q R Ss T U Vv Ww X Y Z A B C 4 2 


cooitoos 
000100 ABCDE FGHIJ KLMNO PQRST UVWXY ZABCD EFGHI JKLMN OPQRS TUVWX YZABC DEFGH IJKLM NOPQR Characters, 
five-byte 
000216 STUVW XYZAB CDEFG HIJKL MNOPQ RSTUV WXYZA BCDEF GHIJK LMNOP QORSTU VWXYZ ABCDE FGHIJ ence 


C004 
00025C 05860 4890 8046 1A98 48A0 8046 1A89 48B0 8046 LABA 47F0O BO5A 48C0 8058 48E0 803A Hexadecimal, 


BALR LH AR LH AR LA AR BC LH LH with 
mnemonics 


coo27Cc L4FE 43EE 8048 42EC 803E 88F0 0004 46CO 801A 58FO 8042 58E0 803E O7TF1 OOOF 0006 
x 


NR Ic STC SRL BCT L L BCR 
C010 
0C029C 2147483647 2147483648- 1234567890- 1234567890 2234567890 1234567890 1234567890 0000000000 _~—‘Full-word 
oo02BC 0000000001 0000000002 00000L0003 0000000004 0000000005 0000000006 ooo00000007 0000000008 Masia 
coos 


0002DC 32767 32768- 12345 12345 12345 12345 12345 12345 12345 12345 12345 12345 12345 12545- Half-word 
fixed-point 
O0ORF2 12345 12345- = 12345 12345 12345 12345 12345 12345 12345 12345 12345 12345 12345 12345- gecimal 


cc0é 
000304 212345678 E OL 212345678 E-O1 212345678 £ 75 212345678 E~-77 212345678 E 10 12345678 E 10 Short~precision 
OCO31C «00000000 E QO «00000000 E 00 «00000000 E 00 «00000000 E 00 «00000000 E 00 «00000000 E 00 oan 
coo7 
000330 -12345678901234567 E 75 ©12345678901234567 E 00 2° 12345678901234567 E-77 © 12345678901234567 E 00 Long-precision 
000350 -00000000000000000 E 00 ©12345678901234567 E 26 © 12345678901234567 kt 00 0 12345678901234567 E OU a 


Note: Main storage addresses are in left-hand margin; format of each listing is preceded by a label . 
Formats are identified by inserts in right-hand margin. 


Figure 3. Example of Storage Print Listing 
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INTRODUCTION 


The Input/Output Support Package con- 
Sists of a modular set of subroutines which 
enable the user to operate input/output 
devices. (A module in the Input/Output 
Support Package is a logical sequence of 
coding which either sets up or executes one 
I/O function.) There are three types of 
modules in the I/O Support Package; they 
are: 


1. Required modules. These modules must 
always be present when the I/O Support 
Package is used. 


2. Optional Modules. These modules need 
not be present to perform the basic 
functions of the I/0 Support Package, 
but can be included to expand the 
facilities of the basic functions. 
(Note: the user physically selects the 
modules that are required and the 
others that he desires from the decks 
supplied by IBM; see “How the I/0 
Support Package is Supplied".) 


3. Entry modules. These modules support 
certain functions of a given I/0 


device, for example, to read a card or 
write tape. 


FORMAT OF PRESENTATION 


Each of the three types of modules’ that 
constitute the I/O Support Package is dis- 
cussed separately in the following order: 

1. Required modules. 
2. Optional modules. 


3. Entry modules. 


The discussions under these three 
provide the following information: 


headings 


e The listing group heading for each 
module is noted in the discussions. 
The listing of the I/O Support Package 
provided by IBM groups all the modules 
under headings which correspond to the 
function of that module; for example, 
the entry modules are grouped under the 
heading "I/O Call Entry Group". 


INPUT/OUTPUT. SUPPORT PACKAGE 


e There is ae set of charts provided at 
the end of the I/0 Support Package 
which illustrates the relationships of 
ali the modules. The discussions point 
out which chart the reader should go to 
for a graphic illustration of module 
relationships. When selecting the 
modules to be used for a given applica- 
tion, the user is strongly urged to 
make frequent reference to these charts 
and to the listing of the I/0 Support 
Package provided by IBM. (When using 
the charts, the user should find the 
name of the module that he desires and 
then follow the arrow that leads from 
that module, taking all branches, and 
include every other module that the 
flow line intersects.) 


After the entry modules have been des- 
cribed, their functions explained, and 
requirements for their use defined, the 


following sections are presented: 


1. Calling the entry modules. This sec- 
tion tells what information the user's 
program must supply to call the entry 
modules. 


2. Direct Linkage. This section explains 
a method of coding to call the entry 
modules when the I/O Support Package 


and user's program are assembled 
together. 
3. Indirect Linkage. This section 


explains a method of coding to call 
the entry modules when the I/O Support 
Package and user's program are assem- 
bled separately. 


The remainder of this section shows how 
to organize the selected modules and pre- 
sents considerations for card-only and lim- 
ited card-tape installations, followed by 
the charts which show the relationships of 
the entire package. 


Because of the modularity of the I/0 
Support Package, the reader will find many 
relationships and dependencies among the 
routines. Therefore, he is urged to first 
read through the entire section and become 
familiar with the general principles that 
govern the use of the I/0 Support Package. 
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HOW THE I/O SUPPORT PACKAGE IS SUPPLIED 


The I/O Support Package is supplied as 
follows: 


1. A symbolic deck, which contains the 
entire I/0 Support Package; the user 
May select those modules that suit his 
particular needs. 


2. An assembled deck which contains the 
entire I/O Support Package. 


3. An assembled deck for use with the IBM 
1052 Printer-Keyboard, the 2540 and 
1442 Card Reader-Punch, and the 1403 
or 1443 Printer (card-only installa- 
tions) ; this version does not contain 
the entire I/O Support Package. For 
information on this version, see 
"Card-Only Installations." 


4. An assembled deck for use with all the 
devices noted in 3, above, and the IBM 
2400 Series Magnetic Tape Units 
(card-tape installations) ; this 


version does not contain the entire 
I/O Support Package. For information 
on this version, see “"Card-Tape 


Installations." 


PREREQUISITE CONSIDERATIONS 


To understand the following discussions, 
the reader must be familiar with the fol- 
lowing information: 


1. The symbolic names of the entry 
modules and a brief description of 
their functions and limitations. 


2. The symbolic names assigned by the I/0 
Support Package to the general reg- 
isters. (These names may be used in 
place of actual register numbers) . 


The following is a list of the subrou- 
tine entry modules. These modules support 
certain functions of a given device and are 
subject to the limitations of the device 
involved. The user is cautioned that no 
check is made to ensure that the calling 
sequence (see “Calling the Entry Modules" 
and "Direct Linkage") for the entry modules 
conforms to the specifications for the 


particular device. For this reason, the 
user should be throughly familiar with 


these specifications as they are explained 
in the reference manuals for the various 
I.’O devices. 

The subroutine 


entry modules are as 
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follows: 


SRDCW Read a card; wait. 

SWMSW Write a message; wait. 

SPRTW Print a line; wait. 

SPUC Punch n columns; no wait; this 
entry is only for a device whose 
punch address differs from the 
reader address (IBM 2540 Card 
Reader- Punch) . 

SRTPW Read tape; wait. 

SPCR Punch n columns; no wait; this 
entry is only for a device whose 
punch address is identical with the 
reader address (IBM 1442 Card 
Reader-Punch) . 

SSNSW Sense information from the desig- 
nated device; wait. 

SCTLW Issue specified control command; 
wait. 

SPCMW Single-space the message unit; 
wait. 

SPCPW Single-space the printer unit; 
wait. 

SKIPW Printer skip to channel one; wait. 

SPCRW Punch n_ columns; wait; this entry 
is only for a device whose punch 
address is identical with the read- 
er address (IBM 1442 Card Reader- 
Punch) . 

SPUCW Punch n columns; wait; this entry 
is only for a device whose punch 
address differs from the reader 
address (IBM 2540 Card Reader- 
Punch) . 

SWTPW Write tape; wait. 

SRWD Rewind tape; no wait. 

SWIMW Write a tapemark; wait. 

SBSRW Backspace one physical record; 
wait. 

SBSF Backspace file; no wait. 

SFSRW Forward-space one physical record; 


wait. 


a a a re ne a ee ee ere re 


1 Wherever “wait™ occurs, it indicates that 
control does not return to the user's 
program until the device reaches the end of 
the operation, including all mechanical 
motion. 


SFSF Forward-space file; no wait. 
SBRTW Backward read tape record; wait. 
Note: These subroutine entry modules may 


be used in any combination; however, since 
they are oriented to function and not to 
device, it is possible that some function 
of a given device may not be _ supported. 
For example, no combination of the entry 
modules will enable the user to read from 
the IBM 1052 Printer-Keyboard. 


The general registers are referred to by 
symbolic names in the I/O Support Package. 


(Note: the user's program may use the 
actual register numbers if it is so 
desired.) The following is a list of the 


symbolic names used in this section equated 
to their corresponding actual register 
assignments: 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 





If these symbolic names are used by the 
user's program, they must’ be defined at 
assembly time; if the I/O Support Package 
is assembled with the user's program, the 


I/O Support Package supplies equivalence 
statements (see “Direct Linkage"); if the 
user's program is assembled separately, 


these names must be defined within the 
user's program (see “Indirect Linkage"). 
The I/O Support Package saves and restores 
these registers. All discussions in this 
section usé the symbolic names of the 
general registers. 


REQUIRED SUBROUTINE MODULES 


The discussion of the required subrou- 
tine modules will deal with the following 
points: . 


1. The Significance 
modules. 


of the required 


2. The names and the group under which 
they can be found on the listing 
provided by IBM. 

3. Considerations about the individual 

module. 


4. Use of the required modules. 


The reader is urged to refer to the 
charts at the end of the I/0 section for 
the relationship of the other parts of the 
I/O Support Package to the required 
modules. The relationship of the required 
modules is illustrated on Chart AA. 


SIGNIFICANCE OF THE REQUIRED MODULES 


The required modules are the foundation 
of the I/0 Support Package; they must 
always be included whenever the I/O Support 
Package is used, regardless of what entry 
or optional modules are selected by the 
user. 


NAMES AND LISTING GROUP 


Table 20 gives the names of the required 
modules and their associated modules; it 
also gives the group name under which they 
can be found on the listing provided by 
IBM. 


Table 20. Names and Listing Group of the Required and Their Associated Modules 

Sa A i eT, SERGE 1 
| Names | Listing Group | 
fam fn nnn nnd 


Primary Call Entry Table 

Secondary Call Entry Table 

I/O Base Routine Part 1 

I/O Base Routine Part 2 

Multiple Unit Device~-Address Routine 
Command Operation Modifiers Routine 
Initial New PSW Set Up Routine 


(ee ee ee ee ee 


| 
| I/O Calli Entry Group 
| I/O Call Entry Group 

| I/O Base Routine - Group 1 
| I/O Base Routine ~ Group 2 
| I/O Base Routine - Group 2 
| 
| 


I/O Base Routine Group 2 
I/O Base Routine Group 2 


Se ee cree a ane ee ce em ce ec enn a at ee een ne ou wer a ee ene eur sore rumreneeees cement st ly copa mene acy ee cee a ne inne ee oe ne ae ne ee i et ee ll 
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PRELIMINARY CONSIDERATIONS 


Before these modules are explained, the 
reader must be familiarized with the fol- 
lowing basic considerations: 


1. Each entry module must have such 
information as device address; this 
type of information is not supplied 


from within the entry module. To 
point out where an entry module 
obtains this information, we may 
‘divide all the entry modules into two 
types: "primary" and “secondary." 
(This is only an illustrative distinc-— 
tion; such a distinction will not be 
found in a listing of the entry 
modules.) 


Table 21 shows which entry modules may 
be considered primary and which secondary. 


The main difference between the primary 


and secondary entry modules is that the 
secondary entry modules are dependent on 
the primary call modules. The paragraph 
following Table 21 explains this depen- 
dence. 

Table 21. Primary and Secondary Entry 

Modules 
De ee Re ee re ee 
Primary 


4 

| Secondary | 

| Entry Modules | Entry Modules | 

SRDCW read card | SPCR punch vdq 

SWMSW unite m SSNSW 

SPRTW we | SCTLW 

SPUC Veet, SPCMW 

SRTPW Lares SPCPW 

SKIPW 

SPCRW 

SPUCW 

SWTPW 
SRWD 

SWTMW 

SBSRW 
SBSF 

SFSRW 
SFSF 

SBRTW 


fe i is cae a a a I a ed 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
L 


SS EE EE NS EE OE AE ES EN UE eRe SE 
Te 


The primary entry modules are provided 
with the information they need to address 
an I/0 device by the Primary Call Entry 


Table module. This module contains the 
address of the primary entry module, the 
device unit address (Note: The user must 
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initially supply the addresses of his de- 
vices to the Primary Call Entry Table), and 


a space for an exceptional condition return 
address. The secondary entry modules have 
a Similar table, the Secondary Call Entry 
Table; however, this table only provides 
the address of the secondary entry module. 
The unit device address and the space for 
an exceptional condition return address are 
obtained from the Primary Call Entry Table. 


2. The reader will find, by referring to 

his listing, that what has been called 
I/O Base Routine - Part 1 in Table 20 
consists of four modules. The names 
of these four modules are: 

e I/O Interrupt Entry 

e Set Up Return 

e Initiate I/O Action 


e Interrogate 
dition Code 1 


I/O Interrupt or Con- 


Because of their functions, they will 
be referred to as if there were only 
two modules: I/O Initiator and Inter- 
rupt Analyzer. 


3. The reader will also find that what 
has been referred to in Table 20 as 
I/O Base Routine Part 2, consists of 2 
modules. Their names are; 


e Save Entry Registers and Initial- 
ize CCW and CAW 


e I/O Operations Control Constants 


They are referred to as: 
and Constants area. 


Housekeeping 


4. The following three routines are spe- 
cial cases: 


e Multiple Unit Address-Device 
tine 


Rou- 


e Command Operation Modifiers Rou- 
tine 


e New PSW Set Up Routine 


They are special cases since, under 
certain conditions, the I/0 Support 
Package could be used without them. 
These conditions are explained in the 
section immediately following. 


USE OF THE REQUIRED MODULES 


The following discussion explains each 
of the required modules and considerations 
for their use, 


Primary Call Entry Table 


This table consists of primary entry 
module addresses, device addresses, anda 
space for the exceptional condition return 
address. This module must always be 
included. For example, if a primary entry 
module is used, the user must include: 
for 


1. The primary entry module itself, 


example, SRDCW. 
2. The Primary Cail Entry Table. 
In organizing the I/O Support Package, the 


Primary Call Entry Table (SINTRY) is placed 
first. 


Secondary Call Entry Table 


This table consists of the addresses of 
secondary entry modules. If a secon- 
the user must 


the 
dary entry module is used, 
include the following: 


1. The secondary entry module itself, for 
example, SKIPW. 


2. The associated primary entry module 
(if any) : although the secondary 
module performs its own specific set- 
up functions, it branches to its 
associated primary entry module for 
all common functions. For example, 
the SKIPW module sets up the command 
parameters and the skip command, then 
branches to the SPRTW module which 

> sets the printer reference and branch- 
es to the Initiate I/O portion of the 
I/O Base Routine. (Table 22, which 
appears later in the text, lists these 
associations.) 


The Secondary Call Entry Table (SNTRY2) 


follows SINTRY when organizing the I/0 
Support Package. 
I/O BASE Routine ~- Part 1 

This part of the I/O Base Routine con- 


Sists of the following: 


e The I/O initiator 
e The interrupt analyzer 


The I/O Base Routine - Part 1 follows the 
SNTRY2 in organizing the I/O Support Pack- 
age. 


Note: All other selected modules should 
follow the I/O Base Routine - Part 1 and 
precede the I/O Base Routine - Part 2 when 
organizing the I/O Support Package. 


I/O Base Routine - Part 2 


This part of the I/O Base Routine con- 


sists of the following: 


1. Housekeeping - This module must follow 
all other modules added after the I/0 
Base Routine - Part 1 and precede the 
constants area. 


2. Constants - This area of constants 
must follow the housekeeping and pre- 
cede all other I/O Base Routine - 
Group 2 modules. 


Multiple Unit Device-Address Routine 


When the user is employing a class of 
device for which the unit address changes 


from call to call, the Multiple Unit 
Address-Device Routine iS required. Each 


time there is vice address, this 


time there is anew device address, this 
address must be loaded right-justified into 
the high-order 16 bits of register SREGN 


1 
When this module is present, these bits are 
always interpreted as a new device address. 


Therefore, if this module is present and a 
new device address is not being used, these 
bits should be set to zero. See "Direct 
Linkage" for the procedures and precautions 
that must be taken. This routine follows 
I/O Base - Part 2 when organizing the I/0 
Support Package. 


Command Operation Modifiers Routine 


When the user wishes to employ any 
command operation modifiers, he must’ use 
the Command Operation Modifiers Routine. 
He must also place the 5-bit modifier 
pattern in the high-order bits of register 
SREGA. Any such bits will be inserted in 
the CCW for the current call. If this 
module is present but modifiers are not 

esired, these its must be _ set to zero. 


desired, these bits must be set to zero. 
See "pire inkage for procedures’) and 


precautions that must be taken. 
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This routine follows the Multiple Unit 
Address-Device Routine, when organizing the 
I/O Support Package. 


New _PSW Set Up Routine 


When the user does not have his own 
routine to set up new PSWs, this routine is 
required. It follows the Command Operation 
Modifiers Routine when organizing the I/0 
Support Package. 


SUMMARY OF REQUIRED MODULES 


This section has provided a verbal des- 
cription of the significance, names, group 
listing, and the use of the required I/0 
Support Package modules. The reader should 
refer to Chart AA for a graphic representa- 
tion of these modules and their relation- 
ship to the other modules in the I/0 
Support Package. 


OPTIONAL SUBROUTINE MODULES 


The next group of modules to be dis- 
cussed are the optional subroutines. These 
modules are not required for the basic uses 
of the I/0 Support Package; they enable the 
user to expand the basic capabilities of 
the package. 


The reader will note that if he wishes 
to select a module to perform a particular 
function, the module he selects may require 
the presence of one or more other modules. 
For this reason, the charts should be used 
along with the verbal descriptions. The 
following is the format of presentation in 
this section: 


1. The names and functions of all of the 
optional subroutine modules will be 
presented, grouped according to the 
heading under which they appear on the 
listing provided by IBM. If, within 
any group, the name of a module is 
indented, this signifies that the 
module requires the presence of the 
last module whose name is not indent- 
ed. For example, the format: 


UE BASE Routine 
UE Printer Routine 


signifies that the UE Printer Routine 


requires the presence of the UE Base 
Routine. Other first level require- 
ments will be noted in the discussion 
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UE Base Routine: 


of individual routines. However, the 
reader is cautioned that these discus- 
sions are intended only as an aid to 
understand the routines, not to point 
out all dependencies. Dependencies 
are illustrated on the charts at the 
end of the I/0 section; the chart 
reference for each group is noted next 
to the name of the group. 


2. This part also presents some practical 
functions that a user might select and 
lists the modules that are required 


for this function. Here also the 
reader should refer to the charts for 
second-level dependencies. 
LISTING GROUP, NAMES, AND FUNCTIONS 
The following pages provide the user 
with a brief explanation of the functions 


of the optional modules and their first- 
level requirements. 


Unit Exceptional Condition (UEC) Group 


Chart: DD 


This routine is entered 
when an exceptional condition indication 
occurs. It directs control to the UE 
Specific Unit Base Routine; if that module 
is not present, it directs control to Set 
Up Unit Exception Return Address routine. 
If only the UE Base Routine is present, an 
error wait will ensue. 


UE Specific Unit Base Routine: This 
routine enables the attachment of other 


routines that provide for specific reac- 
tions to a UEC on a given device. If 
the UE Printer Routine is present, con- 
trol passes to that routine; if not, 
control returns to the UE Base Routine 
to check for the exit to the Set Up UE 
Return Address Routine. 


Set Up Unit Exception Return Address: 
This routine will return control to the 


address specified in register SREGL. 
(See “Direct Linkage.") 


UE Printer Routine: This routine deter- 
mines if the UEC originated from the 
printer; if not, control returns direct- 
ly to the UE Base Routine; if it did, 
this routine issues a Skip-To-Channel 1 
instruction to the printer. (This is 
used to restore the printer to a line 1 
position on the next page.) Control 
then returns to the UE Base Routine to 
check for the exit to the Set Up UE 
Return Address Routine. 


I/O Base Routine - Group 1 


Condition Code _ 1 Unit Identity Display: 
This routine places the current device 


address and device: identification in the 
I/O Old PSW. (Chart AA) 


Minor Interrupt Conditions Base Routine: 
This routine makes it possible to check for 


incorrect record length, program control 
interrupt, and/or attention bits. For any 
one of these indications, it branches to 
the appropriate routine, namely, Incorrect 
Length Record Indication Base Routine, Pro- 
gram Control Interrupt Base Routine, Atten- 
tion Base Routine (each of these three 
routines requires the presence of the Minor 
Interrupt Conditions Base Routine). If 
these indications are not found, or if the 
appropriate module is not present, control 
is directed to the Interrupt Analyzer por- 
tion of the I/O Base Routine. (Chart BB) 


Incorrect Length Record Indication Base 


Routine: This routine checks for an 
incorrect length record: if there is 
one, it branches to the Interrupt Ana- 
lyzer portion of the I/O Base Routine; 
if not, it branches back to the Minor 
Interrupt Conditions Base Routine to 
check for a PCI indication. 


Program Control Interrupt Base _ Routine: 


This routine checks for a program con- 
trol interrupt: if there is one, it 
branches to the Interrupt Analyzer por- 


tion of the I/O Base Routine; if not, it 
branches back to the Minor Interrupt 
Conditions Base Routine to check for an 
Attention indication. 


Attention Base Routine: This routine 
checks for an attention bit: if there is 
one, it branches to the Interrupt Ana- 
lyzer portion of the I/O Base Routine; 
if not, it branches back to the Minor 
Interrupt Conditions Base Routine. 


Issue Internal Call Routine: This routine 
is required for the operation of the fol- 
lowing four optional modules: Internal Unit 
Sense Routine, Write Error Message Base 
Routine, Tape Retry Routine, UE Printer 
Routine. Each of these routines uses’ the 
Issue Internal Call Routine to save the 
current registers, set the internal cail 
Switch on, save the current I/O Old PSW and 
CSW, branch to the internal call entry, and 
restore, after the internal call, all the 
locations saved. (Chart BB) 


Internal Unit Sense Routine: This rou- 
tine also requires the presence of the 
SSNSW entry module. It saves the cur- 
rent general registers and branches to 


Save and Restore External New PSW: 


the Issue Internal Call Routine. When 
the internally called sense routine is 
completed, it restores the registers and 
I/O Old PSW and returns control to the 
calling routine. 


Write Error Message Base Routine: This 
routine also requires the presence of 


the SWMSW entry module and the Condition 
Code 1 Unit Identity Display Routine. 
If the interrupt device is the message 
unit, this routine loads a wait-state 
PSW. If it is not, an error message 
will be written on the appropriate unit 
and the routine will then load a wait- 
state PSW. 


Write Error Routine - Expansion 1: This 


routine also requires the presence of 
the Write Error Message Base Routine and 
the Binary-to-Hex Conversion into Image 
Routine. This routine causes the [I/0 
Old PSW and the CSW to be written, in 
addition to the information provided by 
the Write Error Message Base Routine. 


Binary-to-Hex Conversion into Image 


Routine: This routine converts binary 
bytes into two hexadecimal characters 
each and sets the characters in the 
indicated field. 


Write Error Routine - Expansion 2: This 


routine also requires the presence of 
the Write Error Message Routine - Expan- 
sion 1, and the Internal Unit Sense 
Routine. This routine causes the six 
sense bytes transmitted by the device to 
be written, in addition to the informa- 
tion provided by the Write Error Message 
Base Routine and Write Error Message 
Routine - Expansion 1. 


This 
routine saves the current External New PSW 
and replaces it with an External New PSW to 
repeat the I/0 operation with channel, 
external, and machine check interrupts 
disabled. This routine requires the pres- 
ence of the New PSW Set Up Base Routine 
(see the discussion of this module under 
"Required Subroutine Modules") to which it 
returns control. (Chart CC) 


External Interrupt Base Routine: This rou- 
tine determines if the interrupt is a 


console, timer, or external signal inter- 
rupt. If it is a console interrupt, it 
branches to the Initiate I/O Action portion 
of the I/O Base Routine; otherwise, it 
branches to the Interrupt Analyzer portion 
of the I/O Base Routine. Note: The func- 
tion of this routine is to provide exits 





for user-supplied routines that handle 
timer and external signal interrupts. 
(Chart AA) 
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Unit Check Group 


Chart: Cc 


Unit Check Base Routine: 
branch to the Unit Check Tape Routine when 
a unit check has occurred. If the Unit 
Check Tape Routine is not present, an error 
wait will ensue, unless the unit check was 
due to sensing a channel 9 on the printer. 


In this case, the unit check will be 
ignored, unless the user inserts his own 
routine. 


Unit Check Tape Routine: This routine 
also requires the presence of the Inter- 


nal Unit Sense Routine, Internal Call 
Routine, Tape Entry Base Routine, Tape 
Backspace Record Entry Routine, and Tape 
Forward Space Record Routine. This rou- 
tine checks the device address of the 
source of the unit check against that of 
the tape device. If the source was not 
a tape unit, control returns to the Unit 
Check Base Routine; if it was, a sense 
command is issued to the tape unit and 
the sense bits are interrogated. If the 
sense bits indicate that the operation 
may be retried (and is not a data 
check) , another attempt is made. If the 
new attempt is successful, processing 
continues. If the new attempt is unsuc- 
cessful, and the maximum number of 
retries have been made, control is 
transferred to the [Interrupt Analyzer 
portion of the I/O Base Routine. If the 
sense bits indicate that a data check is 
present, control is transferred to the 
Tape Retry Base Routine; if not, or if 
the Tape Retry Base Routine is not 
present, it branches to the Interrupt 
Analyzer. If the sense bits indicate 
that the attempt may not be retried, 
control is transferred to the Interrupt 
Analyzer. 


Tape Retry Routine: This routine also 
requires the presence of the Unit Check 


Tape Routine and the Control Entry 
module (SCTLW). This routine tries to 
perform the original I/O call until it 
is successful or until the maximum num- 
ber (as specified by IBM standards) of 
retries has occurred. If the maximum 
number of retries has occurred, it 
branches to the Tape Read Retry Routine 
or the Tape Write Retry Routine or, if 
the proper routine is not present, to 
the Interrupt Analyzer portion of the 
I/O Base Routine. 


Tape Read Retry Routine —- Backspace 
Cleaner: This routine requires the pres- 


ence of the Unit Check Tape Routine, the 


Tape Tape Retry Base Routine, and the 
Internal Unit Sense Routine. This rou- 
tine performs the backspace cleaner 
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This routine will 


operation by backspacing four records 
(or to load point, if fewer than four 
records have been previously read), then © 
forward spacing to the position of the 
tape at the entrance to the routine. 
The routine then branches to re-issue 
the original call, if the maximum number 
of backspace cleaner operations has not 
been performed. If the maximum number 
of backspace cleaner operations has been 
performed, the routine branches to the 
Interrupt Analyzer portion of the I/0 
Base Routine. 


Tape Write Retry Routine - Erase For- 


ward: This routine requires the presence 
of the Unit Check Tape Routine, the Tape 
Retry Routine, and the Rewind Entry 
Routine (SRWD) . This routine performs 
the erase forward operation and branches 
to re-issue the original call, if the 
Maximum number of operations has not 
been performed. If the maximum number 
of operations has been performed, the 
routine branches to the [Interrupt Ana- 
lyzer portion of the I/O Base Routine. 





I/O Calli Entry Group 


Chart: EE 


Locate SINTRY Table Unit Block: This rou- 
tine sets symbolic register SLUBRG with the 
proper device unit block address. 


Sense Entry Locate SINTRY Table Block 
Exit: This routine also requires the 


presence of the SSNSW entry module. Et 
will effect a branch from the SSNSW 
routine to the Locate SINTRY Table Unit 
Block routine. 


Control Entry Locate SINTRY Table Block 
Exit: This routine also requires the 


presence of the SCTLW entry module. It 
will effect a branch from the SCTLW 
routine to the Locate SINTRY Table Unit 
Block routine. 


PRACTICAL USES OF THE OPTIONAL ROUTINES 


This section describes some situations 
in which the user would select optional 
routines. The situations are ordered so 
that the routines required follow the same 
order in which they were described under 
"Listing Group, Names, and Functions." 


The discussions in this section provide 
more details about the optional routines, 
but should be supplemented by referring to 


do not 
that a 


discussions 
requirements 


the charts, since the 
reflect all module 
routine might have. 


If the user wishes to note and take any 
action in his own program on an exceptional 
condition indication, the following modules 
(Chart DD) must be included: 


e UE Base Routine 
e Set Up Exception Return Address 


The return address to the routine in his 
program which is concerned with the excep- 
tional condition indication must be loaded 
into register SREGL, as explained in 
“Direct Linkage." Whatever is in register 
SREGL is used as the return address. 


If the user wishes to note and take 
action on the printer for an exceptional 
condition when an automatic Skip-to-Channel 
1 has occurred, the following modules 
(Chart DD) must be included: 


e UE BaSe Routine 


UE Specific Unit Base Routine 
e UE Printer Routine 


e Issue Internal Call Routine 


Set Up Exception Return Address 


If, after an error wait resulting from a 
condition code 1, the user would like to 
provide for displaying the address of the 
I/O unit responsible, the following module 
(Chart AA) must be included: 


e Condition Code 1 Unit Identity Display 

If the user wishes to provide to check 
for an incorrect length record, a program 
control interrupt, or attention bits, the 
following modules (Chart _ BB) must be 
included: 


¢ Minor Interrupt Conditions Base Routine 


¢ Incorrect Length Record Indication Base 
Routine 


e Program Control Interrupt Base Routine 
e Attention Base Routine 
If information is to be sensed by one of 
the selected modules, the following modules 
(Chart BB) must be included: 


e Issue Internal Call Routine 


e The SSNSW entry module 


The set of sense bytes transmitted by the 
device will be stored in the symbolic 
locations in the SSNSW routine, starting at 
SNSA. (SNSA is the symbolic name of a 
Six-byte area which is defined by an ENTRY 
instruction in the I/O Support Package. If 
the user defines SNSA as an EXTRN in his 
program, the information stored there can 
be made available to his program.) The 
user must refer to the reference manuals of 
the particular I/0 device for information 
about sense bytes. 


If, before an error wait occurs, the 
user would like to have the three identify- 
ing characters from the address portion of 
the current PSW written on the message 
device, the following modules (Chart _ BB) 
must be included: 


e Write Error Message Base Routine 

e Issue Internal Call Routine 

e SWMSW Entry Module 

e Condition Code 1 Unit Identity Display 
If the user would like to further amplify 
this and also have the I/O Old PSW and CSW 
written on the message unit, he must 
include the four modules listed immediately 
above, plus the following: 

e Write Error Routine - Expansion 1 


e Binary-to-Hex Conversion into 


Routine 


image 


The user can expand the scope of this 
option to write sense information from the 
device that was being operated when the 
interrupt occurred by including the modules 
listed immediately above and the following: 


e Write Error Routine - Expansion 2 
e Internal Unit Sense Routine 


If the user wishes to save the current 
External New PSW to repeat the I/O opera- 
tion with channel, external, and machine 
check interrupts disabled, the following 
modules (Chart AA) must be included: 


e New PSW Set Up Base Routine 
e Save and Restore External New PSW 


If the user wishes to provide for. ser- 
vicing console interrupts under the control 
of an I/O subroutine and still permit the 
attachment of other routines to service 
timer and/or external signal caused inter- 
rupts, the following module (Chart CC) must 
be included: 


e External Interrupt Base Routine 
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If the user wishes to provide for tape 
error retries, the following modules (Chart 
CC) must be included: 

e Unit Check Base Routine 
e Unit Check Tape Routine 


e Tape Retry Base Routine 


e Tape Read Retry Routine 
tape) 


(if reading 


e Tape Write Retry Routine 
tape) 


(if writing 


If the user is employing either the 
control (SCTLW) or the sense (SSNSW) entry 
and he does not want to load the location 
of the device address into register SLUBRG, 


the following module (Chart EE) must be 
included: 

e Locate SINTRY Table Unit Block 
(The device address must appear in the 


high-order 16 bits of register SREGN.) If 
the user’ is employing the Locate SINTRY 
Table Unit Block with the SSNSW entry, he 
must include the following module: 


e Sense Entry Locate SINTRY Table Block 
Exit 


If the user is employing the Locate SINTRY 
Table Unit Block with the SCTLW entry, he 
must include the following module: 


e Control Entry Locate SINTRY Table Block 
Exit 


If the user wishes to interface properly 
with SEREP (System's Environment Recording 
Edit and Print), he must include the fol- 
lowing modules: 

e Issue Internal Call Routine 
e Internal Unit Sense Routine 


e New PSW Set Up Base Routine 


e Unit Check Base Routine 


SUMMARY OF OPTIONAL ROUTINES 


Although the optional routines are not 
necessary for the basic use of the I/0 
Support Package, they do expand the capabi- 
lities of it. To fully understand their 
use, the reader should use the charts along 
with this section. 
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SUMMARY OF I/O ENTRY MODULES 


Charts: EE and FF 

The functions of each of the I/0 entry 
modules are summarized in this section. If 
any entry module requires the presence of a 
module other than the ones previously 
defined, it will be pointed out in the 
discussion of that module. Finally, to 
avoid repetition while describing the entry 
modules, error halts and checking for a 
busy device are discussed in the following 
two paragraphs. 


DETECTION OF ERROR CONDITIONS 


The detection of an error condition may 
follow execution of an I/O subroutine. 
Some subroutines provide for a number of 
retries, if an error prevents successful 
completion of the subroutine. In all 
cases, if a subroutine cannot be completed 
successfully because of an error condition, 
processing halts and information pertaining 
to the error will appear on the operator's 
system console. The operator may then 
choose to retry through Console Interrupts, 
and thereby retry the routine, or he may 
wish to load SEREP to obtain diagnostic 
information. (For a complete discussion of 
error messages and operator actions, see 


IBM System/360 Basic Programming Support 


Operating Guide for Basic Assembler and 
Utilities, Form C28-6557.) 


CHECK FOR BUSY DEVICE 


Every device has a busy bit (the busy 
bit is located in bit position 7 in the 
word in SINTRY that contains the device 
address), which is set after initiation of 
any operation on that device; when the 
operation is completed, this bit is set 
back to zero. The programmer may want to 
test this bit before issuing another I/0 
call to the same device. Figure 4 shows a 
coding sequence for an object program by 
which the programmer can locate and test 
the busy bit. 


In using the entry modules which have no 
wait for the completion of the I/O opera- 
tion, testing this bit is especially impor- 
tant before moving new information into the 
output area. 


When operations that do not wait for 
device end have been accepted by the chan- 
nel, control returns to the user's program 
at the instruction following the calling 


(rr rn rrr ene 


| | 
| EXTRN SINTRY Define Primary Call Entry Table | 
| : I 
: | | 
| L SREGZ, PITBAD Load address of SINTRY | 
| TM QPUC+4 (SREGZ) ,1 Test to see if busy bit is on | 
| BC 1,Xxx Branch if busy | 
{ : | 
| | 
| PITBAD pc A (SINTRY) Define address of SINTRY | 
| QPUC EQU 36 Specify the displacement of the punch | 
| entry module from SINTRY { 
| ) 
| Note: The displacement of device addresses from SINTRY is obtained by adding 4 | 
| to the displacement of the associated primary entry module from SINTRY: thus, to | 
| obtain the displacement from SINTRY of the punch device, 4 is added to the | 
{| displacement from SINTRY of the SPUC entry module. | 
Mace I a a a a te a ee ed 


Figure 4. 


When it is completed, an inter- 
rupt occurs and the busy bit is set to 
zero. If no error was detected, control 
then returns to the user's program at the 
point where the interrupt occurred. 


sequence. 


FUNCTIONS OF THE I/O ENTRY MODULES 


In the 
understood that 


following discussions, it is 
control returns to the 


ee RR 
user's program at the instruction following 
the calling sequence, 1s, the _ byte 


followin the BALR instruction. In the 
entry modules that wait for completion of 
the I/0 operation (all entries whose sym- 
bolic names end in W), control does not 
return until completion; in the others, 
control returns after successful initiation 
of the I/O operation. If the user wants to 
provide for an exceptional condition return 
address, register SREGL must be loaded as 
described in “Direct Linkage” and the 
modules specified in “Optional Subroutine 
Modules" must be included. Finally, the 
number of bytes to be transmitted (that is, 
the number of bytes the programmer loads 
into register SREGN) must not exceed the 
capacity of that device, nor can it be 
zero, Since this is an invalid byte count 
to the channel. ; 


Read A Card (SRDCW) 


The number of columns specified in reg- 
ister SREGN are read into the area _ speci- 
fied by register SREGA. 


Coding in User's Program to Test Busy Bit 


Write a Message (SWMSW) 


The number of bytes specified in reg- 
ister SREGN are typed by the IBM 1052 
Printer-Keyboard. 


Print n Columns (SPRTW) 


The number of columns specified in reg- 
ister SREGN are written on one line. 


Punch n Columns (SPUC) 


The number of columns specified in reg- 
ister SREGN are punched. This punch entry 
is for use only with units which have 
individual punch addresses, such as the IBM 
2540 Card Reader-Punch. 


Read Tape n Bytes (SRTPW) 


The number of bytes specified in reg- 
ister SREGN are read into the area speci- 
fied by register SREGA. (Minimum record 
length is 12 bytes.) 


Note: The use of this entry requires’ the 
presence of the Tape Entry Base Routine 
module. 
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Punch n Columns (SPCR) 


The number of columns specified in reg- 
ister SREGN are punched. This entry is for 
use only with dual service units whose read 
and punch addresses are identical (IBM 1442 
Card Reader-Punch). 


Note: The IBM 1442 Card Reader-Punch does 
not advance cards automatically from the 
punch station; therefore, whenever it is 
necessary to move a card from the punch 
station, the user must include a dummy 
read-a-card calling sequence to eject the 
card when punching is completed, or the 
Command Operation Modifier Routine. 


Sense (SSNSW) 


To determine the status of an I/0 
device, a sense instruction is issued to 
the unit designated by symbolic register 
SLUBRG (General Register 6), which must 
contain the location of the device address 
cell in the Primary Call Entry Table. The 
set of sense Sytes transmitted by the 
device is stored in symbolic location SNSA. 
The number of bytes transmitted is deter- 
mined by the device, the maximum being six. 
The user is referred to the reference 
manuals of the particular I/O devices for 
interpretations of sense bytes. See "Sense 
Entry Example." 


Issue Specified Control Command (SCTLW) 


A control command for the operation 
specified through the Command Operation 
Modifier Routine is issued to the control 
device whose address is specified in reg- 
ister SLUBRG. See “Control Entry Example." 


This entry requires the following condi- 
tions. 


1. The Command Operation Modifier Rou- 
tine, to specify the operation of the 
control command, must be included. 


2. SLUBRG must contain the location of 
the device address at the time of 
entry to this routine; or the Locate 
SINTRY Table Unit Block Routine and 
Control Entry Locate SINTRY Table 
Block Exit module must be included, 
and the high-order 16 bits of register 
SREGN must contain the device address 
as it appears in SINTRY. 
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Single Space Message Unit (SPCMW) 


A line consisting of one blank character 
is written on the message unit. No data 
parameters are necessary.‘ 


Single Space Printer (SPCPW) 


A line consisting of one blank character 
is written on the printer. No data param- 
eters are necessary.? 


Printer Skip to Channel One (SKIPW) 


A control commmand initiating a Skip-to- 
Carriage Tape One is issued to the printer. 
No data parameters are necessary.!1 


Punch n Columns (SPCRW) 


The number of columns specified in 
register SREGN are punched. This punch 
entry is for use only with dual service 
units whose read and punch addresses are 
identical (IBM 1442 Card Reader-Punch). 


Note: The IBM 1442 Card Reader-Punch does 
not advance cards automatically from the 
punch station; therefore, whenever it is 
necessary to move a card from the punch 
station, the user must include a dummy 
read-a-card calling sequence to eject the 
card when punching is completed, or the 
Command Operation Modifier Routine. 





Punch n Columns (SPUCW) 


The number of columns specified in reg- 
ister SREGN are punched. This punch entry 
is for use only with units which have 
individual punch addresses, such as the IBM 
2540 Card Reader-Punch. 


1Note: Although the data registers need not 
be loaded for the operations so noted, the 
specifications (noted in “Direct Linkage") 
for using the Multiple Unit Address-Device 
Routine and Command Operations Modifiers 
Routine must be adhered to. 


Write Tape n bytes (SWTPW) 


The number of bytes specified by reg- 
ister SREGN are written from the area 
specified by register SREGA. (Minimum 
record length is 18 bytes.) 


Note: This entry requires the Tape Entry 
Base Routine. 


Rewind (SRWD) 


The tape is rewound. When the rewind 
has been initiated, control returns to. the 
user's program at the instruction following 
the calling sequence. No data parameters 
are necessary.'*t 


Note: This entry requires the Tape Entry 
Base Routine. 


Write Tape Mark (SWIMW) 


A tape mark is written on the specified 
tape. No data parameters are necessary.! 


Note: This entry requires the Tape Entry 
Base Routine. 





Backspace Record (SBSRW) 


The appropriate tape is backspaced over 
the physical record. (A tape mark is 
recognized as one physical record.) No 
data parameters are necessary.’ 


Note: This entry requires the 
Base Routine. 


Tape Entry 





- 


Backspace File (SBSF) 


The appropriate tape is backspaced over 
the first tape mark encountered. No data 
parameters are necessary.!' 


Note: This 
Base Routine. 


entry requires the Tape Entry 





Forward Space Record (SFSRW) 


The appropriate tape is spaced forward 
one physical record. No data parameters 
are necessary. 


Note: This entry requires the presence of 
the Tape Entry Base Routine. 





Forward Space File (SFSF) 


The appropriate tape is spaced forward 
over the first tape mark encountered. No 
data parameters are necessary.1 


Note: This entry requires the presence of 
the Tape Entry Base Routine. 





Backward Read Tape Record (SBRTW) 


The number of bytes specified in reg- 
ister SREGN are read in backward motion 
into the area specified by register SREGA. 
(Minimum record length is 12 bytes.) 


CAUTION: The address in register SREGA for 
this routine should be the last address 
that is to be read into, rather than the 
starting address. (The user is referred to 
the reference manuals for the appropriate 
tape units for a discussion of reading in 
backward motion.) 





Note: This entry requires the presence of 
the Tape Entry Base Routine. 


Table 22 shows the required modules for 
each of the entries. The following consid- 
erations should be remembered when reading 
this table: 


1. All required routines must be present. 
included in 


2. No optional routines are 
the table. 


ORGANIZATION OF THE SUBROUTINE MODULES 


Once the user has’ selected all the 
modules he requires, he must then organize 
them in the following sequence: 


1. He places the Primary and Secondary 
Call Entry Tables first in the deck. 


*Note: Although the data registers need 
not be loaded for the operations so noted, 
the specifications (noted in "Direct 
Linkage") for using the Multiple Unit 
Address-Device Routine and Command Opera- 
tions Modifiers Routine must be adhered to. 
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2. Then, he places the part of the I/0 5. If any of the following modules are 
Base Routine that contains the I/0 selected, they would come last in the 
Initiator and the Interrupt Analyzer. deck: Multiple Unit Address-Device 


Routine, Command Operation Modifiers 

Routine, New PSW Set Up Routine. 

3. He may then place, in any order, all 
the other modules he has selected, as 
long as all ORG statements follow any 
symbol they refer to. 


Figures 5 and 6 show two possible organ- 
izations of modules. The figures read from 
the bottom to the top. 


4%. He places the second part of the I/0 
Base Routine, which contains the I/0 
Base Routine's general: housekeeping 
and constants area. 


Note: The user may follow the order he 
finds in examining the assembly listing of 
the modules as they were received from IBM. 





fable 22. Module Relationships 
erie ey, lara aaa maaan a ee ee Re eee ee 1 
{| Entry | | | 
{ Module _ | Type | Additional Modules Required | 
faa i aaa af a a a a cre nc aanenenennrennnd 
| SRDCW | Primary | Primary Call Entry Table. | 
| SWMSW | Primary | Primary Call Entry Table. | 
| SPRTW | Primary | Primary Call Entry Table. | 
| SPUC {| Primary | Primary Call Entry Table. | 
| SRTPW | Primary | Primary Call Entry Table, Tape Entry Base Routine. | 
| SPCR | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | SRDCW. | 
| SSNSW | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | Symbolic register SLUBRG must contain the location | 
| | | of the unit device address of the Primary Call Entry | 
| | | Table module. | 
| SCTLW | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| i | Command Operation Modifier Routine, and either SLUBRG | 
| | | must contain the control device unit block address or | 
| | | the following two modules must be included: Locate | 
| | | SINTRY Table Unit Block Routine, Control Entry Locate | 
| | SINTRY Table Block Exit. | 
SPCMW | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | SWMSW entry module. | 
| SPCPW {| Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | SPRTW entry module. | 
| SKIPW | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | SPRTW entry module. | 
| SPCRW | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | SRDCW entry module. | 
| SPUCW | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | SPUC entry module. | 
| SWTPW | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | Tape Entry Base Routine. | 
| SRWD | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | Tape Entry Base Routine. | 
| SWIMW | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | Tape Entry Base Routine. | 
| SBSRW | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | Tape Entry Base Routine. | 
| SBSF | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | Tape Entry Base Routine. | 
| SFSRW | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | Tape Entry Base Routine. | 
{ SFSF {| Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | Tape Entry Base Routine. | 
| SBRTW | Secondary | Primary Call Entry Table, Secondary Call Entry Table, | 
| | | | 
L 4 r 
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Tape Entry Base Routine. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


EO re 


Constants 





--I/O Base Routine; housekeeping and constants area. 
Housekeeping 


6. (Geant --Secondary entry module; requires the presence of numbers 
ty 255 


ae ( SPRITW ~-Primary entry module; requires the presence of number 1. 
4. ( SRDCW ~-Primary entry module; requires the presence of number 1. 






Interrupt 
Analyzer 

3. --I/O Base Routine; I/O Initiator of Interrupt Analyzer. 
I/O Initiator 

2 Secondary Call -~-Contains address of secondary entry module (number 6) ; 
Entry Table uses unit address from Primary Call Entry Table 

(number 1). 

1. Primary Call --Contains address of primary entry module (numbers 4 

Entry Table and 5), device unit address, and space for exceptional 


condition return.. 


eS 
bee ce OE ED ES ED ES NS ES ES SS SS SEED a eee aoe owes ool 


Coe a a eo a oe a ee a a ae a a a a a a a aaa a a ee 


Figure 5. Organization of Subroutine Modules without Optional Routines 
(Read from bottom to top.) 


p---- no --- - - + 

10. Multiple Unit ~-Enables user to use a new unit device address. 
Addr-Dev. Rt. 
Constants 

9. -~-I/O Base Routine; housekeeping and constants area. 
Housekeeping 

8. ( SPCPW --Secondary entry module; requires the presence of numbers 

1925.85 

7. ( SPRTW -~Primary entry module; requires the presence of number 1. 

6. ( SRDCW ~-Primary entry module; requires the presence of number 1. 

Da Unit Ex. Cond. --Enables user to take action in his program on an excep- 
Rtrn. Adr. Rt. tional condition indication. 

4. Unit Ex. Cond. --Enables user to take action in his program on an excep- 
Base Routine tional condition indication. 





Interrupt 





--I/O Base Routine, first in deck; 


3. Analyzer 
I/O Initiator and Interrupt Analyzer. 
I/O Initiator 
2~ Secondary Call --Contains the address of the secondary entry (number 8), 
Entry Table requires presence of number 1 for unit device address. 
1. Primary Call --Contains the address of primary entry modules (numbers 6 
Entry Table and 7, unit device address for numbers 6, 7, and 8, and 
space for exceptional condition return address). 
ae Sa a 


Ne | 


Figure 6. Organization of Subroutine Modules with Optional Routines 
(Read from bottom to top.) 
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CALLING THE ENTRY MODULES 


There are two possible methods of call- 
ing the entry modules: directly and indi- 
rectly. Direct linkage may be used only 
when the selected modules of the symbolic 
I/O routines are assembled with the user's 
program. (In this case, the pertinent 
ENTRY instructions may be removed.) Indi- 
rect linkage must be used when the selected 
modules, in assembled form (either as sup- 
plied by IBM or those separately assembled 
by the user) are not assembled with the 


user's program. The indirect method may 
also be used when the selected modules are 
assembled with the user's program. Since 
the indirect method may be used in both 
instances, it is the preferred method. 

With either of these methods, the 
selected entry module is called by loading 


the following information into general reg- 
isters and transferring control by a BALR 
instruction: 


1. The address of the I/O entry module. 
2. The address of the I/O area. 
3. The number of bytes to be processed. 


Note: Each installation 
supply the addresses of its I/O devices to 
the Primary Call Entry Table. This may be 

done by changing the symbolic cards prior 

to assembly, or by Replace cards at execu- 
ion time. 


must initially 


Wherever an exceptional 
occur, another general 
(SREGL) is loaded with the return address 
to the routine in the user's program that 
uses the unit exceptional condition; for 
example, End of File. 


condition may 
storage register 


DIRECT LINKAGE 


The user may employ any coding sequence 


which provides all the information speci- 
fied in “Calling the Entry Modules." 
(Examples of the coding follow this sec- 
tion.) One possible coding sequence when 
the user's program and I/O Support Package 
are assembled together is as follows: 

LA SREGZ, Xxxx 

LA SREGA, YYYY 

LA SREGN,n 

LA SREGL, ZzzZz 

BALR SREGR, SREGZ 


The following is an explanation of this 
coding sequence. 
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LA SREGZ, XXXX 


Load the address of the desired entry 
module; for example, SRDCW. 

where: 

SREGZ is the general register which is 


loaded with the address of the desired 
entry module: General Register 1. 


xxxx is the address of the desired entry 
module, for example, SRDCW, SPCR, etc. 


LA SREGA, YYYY 


Load the address of the first byte of data 
to be processed. 


where: 


SREGA is the general register which is 
loaded with the address of the first 
byte to be processed: General Register 
2. 


yyyy is the address of the first byte of 
data to be processed. 


‘CAUTION: To employ any command operation 
modifiers, the Command Operation Modifiers 
Routine must be included. The user must 
also place the 5-bit modifier pattern in 
the high-order bits of register SREGA. Any 
such bits will be inserted in the CCW for 
the current call. 


If the Command Operation Modifiers Rou- 
tine is being employed, this instruction 
may be replaced by the following coding in 
the user's program: 


L SREGA, MOBITS 
DS OF 
MOBITS pc X*mm' * 


DC AL3 (YYYY) 


* One byte containing the modifier bit 
pattern. 


No_check is made forthe validity _or 
applicability of an such modifier bits 
found in register SREGA. Any future action 
or corrective measures for conditions pro- 
duced by the user-supplied modifiers may 
not exist in the I/O Support Package. (See 
the reference manuals for the particular 
I/O device for bit pattern data.) Finally, 
the I/O Support Package always interrogates 
the high-order 5 bits of register SREGA; 


therefore, the user should be certain that 
they are set to zeros if the Command 
Operation Modifiers Routine is present but 
is not being used in the current call. 


LA  SREGN,n 


Load the number of bytes (may not exceed 


65,535) to be processed. 
where: 
SREGN is the general register which is 


loaded with the number of bytes of data 
to be processed: General Register 3. 


n is the number of bytes of data to be 
processed. 

The high-order 16 bits of this register 
may be used to hold the address of a new 
device which was not specified in the 
source program, (The original device 


address is supplied by the programmer to 
SINTRY in his I/O package source program. 
Corrections to the device address in SINTRY 


may be made at assembly time by symbolic 
card changes, at load time by Replace 
cards, and at execution time by manual 


stores from the console.) This may be done 
by including the Multiple Unit Address- 
Device Routine and loading the new address 
into the high-order 16 bits of register 
SREGN by the following coding in the user's 
program: 


L SREGN, DEVADR 
DS OF 

DEVADR bc X*Addr'° 
DC H'n' 


However, when the Multiple Unit Address- 
Device Routine is present, any bits found’ 
in the high-order 16 bits of register SREGN 
are always interpreted as a device address. 
Therefore, when an alternate device address 
is not going to be used, the programmer 
should be certain these bits are set to 
zeros. 


LA SREGL,ZZZzZ 


Load the return address to that routine in 
the user's program which uses an 
exceptional condition indication. (If the 
user desires this option, he must include 
the modules specified for it under 
“Optional Subroutine Modules.") 


where: 


SREGL is the general register which is 
loaded with the return address to that 
point in the user's program which uses 
an exceptional condition indication: 
General Register 4. 


ZZzz is the address in the user's 
that uses the exceptional 
indication. 


program 
condition 


If the modules specified for an excep- 
tional condition return address in 
"Optional Subroutine Modules" are present, 
and if the exceptional condition indication 
is not significant, this register should 
contain the normal return address to the - 
current call. It need not be loaded for 
other routines. If an exceptional condi- 
tion occurs and these modules are not 
present, an error wait will ensue. 


BALR SREGR,SREGZ 


Branch and Link. 


where: 
SREGR is the general register which is 
loaded with the return address to the 


user's program, making linkage possible: 
General Register 0. 


EXAMPLE OF DIRECT LINKAGE 


The following is an example of the 
coding in the user's program that is assem- 
bled with the I/O Support Package. The 


first set of coding uses symbolic register 
names; the second set uses the actual 
register numbers. Both sets assume the 
following: 


1. All required routines are present. 
2. The area INFORM is defined in the 
user's program. 


3. The routine beginning at CHKRT notes 
the occurrence of an exceptional con- 
dition and the appropriate modules are 
present. 


4. The user wishes to write on the IBM 
1052 Printer~Keyboard. 


5. 32 bytes are to be written beginning 
from INFORM. 
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Coding with symbolic register names: 


INDIRECT LINKAGE 


LA SREGZ , SWMSW Load address of the As was pointed out, the preceding coding 
routine to write a mes- sequence may be used only when the I/0 
sage. Support Package is assembled with the 

LA SREGA,INFORM Load address of the user's program. When the I/O Support Pack- 
first byte of the area age is not assembled with the user's pro- 
to be written from. gram, he must use a different sequence of 

LA SREGN, 32 Load number of bytes to coding (this sequence may also be used when 
be written. the I/O Support Package is assembled with 

LA SREGL, CHKRT Load address of routine the user‘s program). 
in user's program that 
uses exceptional condi- 
tion indication. 

BALR SREGR, SREGZ Branch and Link. If the user's program and I/O Support 

Package are not assembled together, the 
user must employ the call entry tables to 
produce the entry linkage. The starting 

Coding with actual register numbers: address of the Primary Call Entry Table is 
symbolic name SINTRY; the starting address 
of the Secondary Call Entry Table is sym- 

LA 1,SWMSW bolic name SNTRY2. Figure 7 shows’ the 

LA 2, INFORM construction of the Primary Call Entry 

LA 3,32 Table and Figure 8 shows the construction 

LA 4 ,CHKRT Secondary Call Entry Table. 

BALR 0,1 

Petes ee ON ee ode. |~| | SC*C 

| SINTRY DS 0D Define starting address of table | 

| DC A (SRDCW) Read card and wait | 
| SUTAB EQU * Define first device entry | 
| SCRDR DC A (10) = COA Card reader address | 
| DC A (0) Area for unit exceptional condition return | 
| address | 
| . | 

{ DC A (SWMSW) Write message and wait | 

| STYPR pc A(9) =°9o04 Typewriter address | 

| pe A (0) Area for unit exceptional condition return | 
| address | 

{ * | 

| DC A (SPRTW) Print a line and wait | 

| SPRTR DC A (11) = 008 Printer address . | 
| DC A (0) Area for unit exceptional condition return | 
| address | 

| DC A (SPUC) Punch i 

| SPNCH DC A (13) = cod Punch address | 

| pc A (0) Area for unit exceptional condition return | 

{ address l 

| * Note:. This unit block used only | 

{ * for punch whose unit address | 

| * differs from the card reader. | 

| . | 
| DC A (SRTPW) Read tape record and wait z | 
| STAP DC A (180) Tape address | 
| pc A (0) Area for unit exceptional condition return | 
| address | 
| . | 

{ = | 

| SDUMD DC A (0) Dummy entry - termination | 

| pc A (61440) Dummy entry - termination | 
| * | 
| | 

a ee eh ceed 

Figure 7. Primary Call Entry Table 
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| 
: 
: 
| 


SNTRY2 EQU * 
DC A (SPCR) 
DC A (SSNSW) 
pc A (SPCMW) 
DC A (SPCPW) 
DC A (SKIPW) 
pc A (SPCRW) . 
DC A (SPUCW) 


A (SWTPW) 
Dc A (SRWD) 
DC A (SWIMW) 
DC A (SBSRW) 
Dc A (SBSF) 
pc A (SFSRW) 
Dc A (SFSF) 
pc A (SBRTW) 
DC A (SCTLW) 


eee eae ee ee nee ae ts ee ee me a SE SO a ce SPUD me ee sy 
Oo 
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Define starting address of the table 
Punch (reader) 

Sense 6 bytes 

Typewriter single space 

Printer single space 

Printer skip-to-channel 1 

Punch (reader) and wait 

Punch and wait 

Write tape record and wait 

Rewind tape 

Write tape mark and wait 

Backspace tape record and wait 
Backspace tape file 

Forward space tape record and wait 
Forward space tape file 

Read tape record backward and wait 
Issue control command 
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Figure 8. Secondary Call Entry Table 


In order to use the entry tables, the 
user must first define them in his object 


program. He does this as follows: 
EXTRN SINTRY 
EXTRN SNTRY2 


The next step is to load the address of 
the desired entry module into a general 
register. These tables reveal two facts 
pertinent to loading this address: 


1. It takes two instructions to load this 
address. The address of the table is 
first loaded into a general register. 
The second instruction uses this gen- 
eral register to load the address of 
the desired entry module. 


2. Each of the locations in the tables 
that contain the address of an entry 
module is displaced from the starting 
address of the table by a certain 
number of bytes. Therefore, to load 
the address of any entry module from 
the entry tables, the coding sequence 
must reflect the displacement of that 
location in the entry table which 
contains the address of the desired 
entry module. This displacement may 
be defined by the use of Equate (EQU) 
instructions in the user's program. 
Figure 9 shows the exact displacement 
for all of the entry modules. The 
reader should note that he may use any 
symbolic name for the entry modules in 
the EQU instructions, as long as he 
does not use their actual symbolic 


name; that is, he may not use SRDCW, 
SPCPW, etc., as a symbolic name, (if 
he did, there would be duplicate 
symbols) . 








a a ca aaa a 
| | | 
| 1. Displacement of Primary Entry | 
| Module Addresses from SINTRY | 
| 
| Entry Qpera~ Bytes from | 
| Address tion SINTRY | 
| QORDCW EQU 0 { 
| QWMSW EQU 12 | 
| OPRTW EQU 24 | 
| OPUC EQU 36 | 
| ORTPW EQU 48 { 
| | 
| 2. Displacement of Secondary Entry | 
| Module Address from SNTRY2 | 
| | 
| Entry Opera- Bytes from | 
| Address tion SNTRY2 | 
| QPCR EQU 0 | 
| QSNSW EQU 4 | 
| QPCMW EQU 8 | 
| QOPCPW EQU 12 | 
{ QKIPW EQU 16 | 
| OPCRW EQU 20 | 
| QOPUCW EQU 24 | 
| QWTPW EQU 28 | 
| QRWD EQU 32 | 
j QWTMW EQU 36 | 
| QBSRW EQU 40 
| QOBSF EQU : KY | 
| OFSRW EQU 48 | 
| OFSF EQU 52 | 
| QOBRTW EQU 56 | 
| OCTLW EQU 60 | 
Shea a a eee oe a ee 4 
Figure 9. Displacement in Entry Tables 
Thus, what the user must effectively do 


address of 
Once the user has estab- 
addresses of SINTRY and SNTRY2 


is add the displacement to the 
SINTRY or SNTRY2. 
lished the 
by: 
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PITBAD Dc 
SETBAD pc 


A (SINTRY) 
A (SNTRY2) 


and the displacement from these addresses 
of that location in the table that contains 
the address of the desired entry module 
(for example, the routine to print a line), 
by: 


OPRTW EQU 24 


he can then load the address of this 
routine by the following two instructions: 


Load the address of 
SINTRY 

Load the contents 
of the location 
SINTRY+#24, in this 
case the address of 
the SPRTW entry 
module 


L SREGZ,PITBAD 


L SREGZ,QPRTW (SREGZ) 


These two instructions 
the same purpose as: 


replace and serve 


LA SREGZ , XxxXX 


which was the first instruction in the 


coding sequence noted in “Direct Linkage." 
All the other instructions in that 
sequence, that is: 

LA SREGA , YYVY 

LA SREGN ,n 

LA SREGL ,ZZZz 

BALR SREGR , SREGZ 


remain the same, if the register assign- 
ments are equated as in the I/O Support 
Package, and all specifications which were 
described there also apply when they are 
used as part of the linkage format for a 
user's program that was assembled separate- 
ly from the I/0 Support Package. 


Figure 10 is an example of the linkage 
format for a user's program that was assen- 
bled separately from the I/O Support Pack- 
age. The following assumptions are made in 
this example: 
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1. The only entry modules desired are 
SPCRW and SWMSW. 


2. Symbolic register names are used. 
Note: The user may employ the actual 
register numbers, if it is so desired. 





SENSE ENTRY EXAMPLE 


This section provides a coding example 
of the SSNSW entry. The following assump- 
tions are made in this example: 


1. All required modules are present. 


2. Information is to be sensed from the 
printer. 


3. The I/O Package was assembled 
ately from the user's program. 


separ- 


4. The user will load the unit reference 
into register SLUBRG. 


5. The SSNSW entry will transmit the 
sensed data to the area defined by the 
I/O Support Package - beginning at 
symbolic location SNSA, which must be 
defined by an EXTRN in the user's 
program. SNSA is defined as an ENTRY 
in the I/O Support Package. 


Figure 11 illustrates the coding in the 
user's program. 


If the user did not want to load the 
unit reference into register SLUBRG, he 
would do the following: 


1. Include the Locate SINTRY Table Unit 
Block and Sense Entry Locate SINTRY 
Table Block Exit modules. 


2. Place the address of the device in the 
high-order 16 bits of register SREGN; 
this may not be a new device address. 


OQWMSW 


OPCRW 


SREGZ 
SREGA 
SREGN 
SREGL 
SREGR 


Note: 
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Figure 10. 


EQU 


EQU 
EQU 
EQU 
EQU 
EQU 


DC 
DC 


SINTRY 
SNTRY2 


SREGZ, PITBAD 
SREGZ , OWMSW (SREGZ) 


SREGA,yyyy 
SREGN,n 

SREGL,ZZZ2 
SREGR, SREGZ 


SREGZ, SETBAD 
SREGZ , OPCRW (SREGZ) 


SREGA, yyyy 
SREGN,n 
SREGR, SREGZ 


12 


20 


OfFWN = 


A (SINTRY) 
A (SNTRY2) 


Define Primary Call Entry Table 
Define Secondary Call Entry Table 


Load the address of SINTRY 

Load the contents of the Location SINTRY+12, 
in this case the address of SWMSW 

Load address of first byte to be processed 

Load the number of bytes to be processed 

Load exceptional condition return address 

Branch and Link 


Load the address of SNTRY2 

Load the contents of the location SNTRY2+20, 
in this case, the address of SPCRW 

Load address of first byte to be processed 

Load the number of bytes to be processed 

Branch and Link 


Specify the displacement (as shown in 
Figure 9) of the location in SINTRY which 
contains the address of the desired entry 
module, in this case, SWMSW 

Specify the displacement (as shown in 
Figure 9) of the location in SNTRY2 which 
contains the address of the desired entry 
module, in this case, SPCRW 

Equate SREGZ to general register 

Equate SREGA to general register 

Equate SREGN to general register 

Equate SREGL to general register 

Equate SREGR to general register 


OfPWN = 


Define the address of SINTRY 
Define the address of SNTRY2 
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If the EXTRN instructions are removed, this coding would also serve when 
the object program and I/O Support Package are assembled together. 
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Example of Indirect Linkage 
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(on 


EXTRN SINTRY 
EXTRN SNTRY2 
EXTRN SNSA 

L 1,SETBAD 
L 1, (4,1) 

L 6, PITBAD 
LA 6,28 (6) 


BALR 0,1 


PITBAD pc 
SETBAD pc 


A (SINTRY) 
A (SNTRY2) 


Figure 11. Sense Entry Coding Example 


CONTROL ENTRY EXAMPLE 


This section provides a coding example 
of the SCTLW entry. The following assump- 
tions are made in this example: 


1. All required modules are present. 
Note: The SCTLW entry requires the 


presence of the Command Operation 
Modifiers routine. 





2. The user wants to provide for an 
immediate space of 3 on the printer; 
the modifier bit pattern for this is 





Define primary calli table 
Define secondary call table 
Define sense area 


| 

| 

| 

| Load address of SNTRY2 

| Load address of Sense Entry 
| Load address of SINTRY 

| Load address of the unit address cell, in this case, 
| : that of the printer 

| Branch and Link to I/0 

| 

| 

| 

| 

| 

t 


Define the address of SINTRY 
Define the address of SNTRY2 
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3. The user will load the unit reference 
into register SLUBRG (register 6). 


4. The I/0 Support Package was assembled 


with the user's program. 


Figure 12 illustrates the coding in the 
user's program. 


If the user did not want to load the 
unit reference into register SLUBRG, he 
would dg the following: 


1. Include the Locate SINTRY Table Unit 
Block and Control Entry Locate SINTRY 


00011. Table Block Exit modules. 
pee” heatyaeks tank ha eiuioesiedeeiags * OO!!! 
| LA SREGZ , SCTLW Load the address of the SCTLW entry | 
| LA SLUBRG,SPRTR Load the address in SINTRY of the unit address | 
| cell, in this case, the printer | 
| _ LA SREGA, MOBITS Load the modifier bit pattern into the high-order | 
{ five bits of register SREGA | 
| LA SREGN, 1 Load a number to ensure that an invalid byte | 
| count of zero is not in register SREGN | 
| LA SREGL, EXCPAD Load the address of the user's routine that | 
| handles an exceptional condition indication | 
| BALR SREGR , SREGZ Branch and Link | 
| ° | 
| | 
| DC OF Align on full-word boundary | 
| MOBITS Dc xX"18° Define the modifier bit pattern; this particular | 
| pattern has the bit configuration 00011000; | 
| it is placed in the high-order byte of register | 
| SREGA and the high-order five bits are interpreted | 
| as the modifier bit pattern. For other modifier | 
| bit patterns, the user is referred to the reference | 
| manual of the particular I/O device | 
| DC AL3 (0) The address portion is not significant | 
| | 
Me a he tea lee nl eh te ee ea ee eee 


Figure 12. Control Entry Coding Example 
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2. Place the address of the device in the 
high-order 16 bits of register SREGN; 
this may not be a new device address. 


CARD- ONLY INSTALLATIONS 


An assembled version of the I/O Support 
Package is provided for card-only installa- 
tions. It includes the following entry 
routines: 


SRDCW 
SWMSW 
SPRTW 
SPUC and SPUCW 
SPCR and SPCRW 
SSNSW 
SKIPW 


All requirements specified in 
"Input/Output Support Package" apply to 
card-only installations with the following 
limitations: 


1. Only the modules required for card I/0 
routines will be included. 


2. The only option provided is for an 
exceptional condition return address. 
The modules required for this option 
will be included. 


3. Modules required for SEREP interface 
are included. 


This version supports the following I/0 
devices: 


e One IBM 2540 and/or 1442 Card Reader- 
Punch 
e One IBM 1052 Printer-Keyboard 


e One IBM 1403 or 1443 Printer 


CARD-TAPE PACKAGE 


Another assembled version of the 1/0 
Support Package is the card-tape package. 
It includes the following entry routines: 


SRDCW 

SWMSW 

SPRTW 

SPUC and SPUCW 
SPCR and SPCRW 
SSNSW 

SKIPW 

STPBKW 

SRTPW 

SWTPW 

SRWD 

SWIMW 

SBSRW 

SBSF 

SFSRW 

SCTLW 


This version supports the following I/0 
devices: 


1. One IBM 2540 and/or 1442 Card Reader- 
Punch. 


2. One IBM 1052 Printer-Keyboard. 
3. One IBM 1403 or 1443 Printer. 


4. Any number of IBM 2400 Series Magnetic 
Tape Units. 


All the requirements specified in the 
"Input/Output Support Package“ apply to 
this card-tape package, with the following 
limitations: 


1. Only the modules required to support 
these entries will be included. 


2. There are four optional facilities 
supplied with this version: 


e Exceptional Condition Routines 
e Tape Retry on Error Routines 


e Muitiple Unit Address-Device 


Routine 


e Command Operation Modifiers Rou- 


tine 


3. Modules 
and tape error recovery are 


required for SEREP interface 
included. 


CHARTS OF MODULE RELATIONSHIPS 


These charts are intended to give the 
reader a view of the dependencies among the 
modules of the I/O Support Package. The 
general approach to these charts is as 
follows: all the modules outside the 
required group may be used independently, 


but the user must follow the flow lines 
from the module he selects back to. the 
required modules and include every module 
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the flow line intersects. More specifi- 
cally, when the user selects any module, he 
should follow the arrow from that module, 
taking all branches, and incorporate in his 
deck all the modules encountered. 


The reader should understand the follow- 
ing criteria for using these charts: 


1. The name (as it appears on the listing 
of the I/O Support Package supplied by 
IBM) of each module is contained in 
process’ blocks. Also in the process 
block is the symbolic starting address 
of the module; for example, Issue 
Internal Call (listing name of the 
routine) , SNTCL (symbolic starting 
address of that routine). 


2. The listing group name is also  con- 
tained on the charts; the reader will 
find these group names in the verbal 
discussions of the I/O Support Pack- 
age. 


3. Above each block containing the name 
of a module, there are a series of 
codes designed to aid the user when 
selecting modules from the I/O Support 
Package. The fields of the code are 
separated by commas. The following is 
an explanation of these codes: 


a. The first two digits are the iden- 
tifying number of the module; 
these digits are found in columns 
76 and 77 of the symbolic decks; 
for example, above the block that 
contains the name SINTRY, the 
first two digits are: 10. These 
digits -~ 10 -- appear in every 
card of the SINTRY module (in the 
symbolic deck) in columns 76 and 
77. 


b. The second field shows the number 
of bytes (these are the initial 
release figures and are subject to 
change) the particular module 
occupies; for example, above the 
block that contains the name of 
the Attention Base Routine, the 
following appears in the first two 


fields: 3J,12,...; where 3J is the 
identifying number and 12 
(decimal) indicates that this 


module occupies 12 bytes. 
c. After the field that indicates the 


bytes occupied by the module, 
there are a series of codes that 
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indicate which modules are used by 
the basic utility programs (this 
is intended as an aid to the user 
who desires to select his modules 
from the I/0 Support Package and 
make his own resident I/0). Table 
23 defines these codes. 


Table 23. Chart Codes for Basic 


Utility Programs 


JALL |This module is used by all the 

{ |basic utility programs. 

jc {This module is provided with the 

jCard-Only version of the I/0 Sup- 

jport Package. 


|Card-Tape version of the I/O Sup- 


jport Package. 


4 
| 
| 
| 
| 
| 
| 
| 
| 
is used by Phase 2 of | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
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| 

{D1 |This module is used by Phase 1 of 
| |the Two-Phase Dump Program. 

{D2 |This module 

| |the Two-Phase Dump Program. 

{DS |This module is used by the Single 
| }phase Dump Program. 

[DT |This module is used by both phases 
| Jof the Two-Phase Dump Program. 

| L |This module is used by the Absolute 
{ jand Relocating Loaders. 

|T [This module is provided with the 
| 

| 

L 


For example, the codes above the block 
that contains the name of the SKIPW entry 
module (J3,36,T,C,D2,DS) are interpreted as 
follows: 


J3 Identifying number; this number appears 
in all cards of the symbolic version of 
the SKIPW module in columns 76 and 77. 


36 6This 
age. 


module occupies 36 bytes in stor- 


— This module is provided with the Card- 


Tape version of the I/0 Support 
Package. 
Cc This module is provided with the Card- 


Only version of the 
Package. 


I/O Support 
D2 This module is used by Phase two of the 
Two-Phase Dump Program. 


DS This module is used by the single phase 
Dump Program. 


REQUIRED MODULES 


CALL ENTRY 
TABLES 


e 
RE ERKEE EEE EE EHH HEHE EE REE ERAERAEE HE g REERKERERERE 


BASE ROUTINE 
GROUP 1 


e 
REKREKAE EEE RE KEE REEEREEERELHREREREREE . REKREERHEKEKRE 


BASE ROUTINE 
GROUP 2 


Chart AA. 


10:68 ALL 
REKEAHD EERE HERE 
* * 
* * 
* SINTRY #Xeee 
* * 
* * 
KEKE RUE ERE HE 
x 
° 
° 
° 
. 
« NO 
o*e 
ce #e 


ot ARE Be 
o* SECONDARY *. YES 
He ENTRIES o*eccee 
He USED ot 
He e% 
he ot 
x 
° 


KKK KO KRKKKEKRE KR KK KE 


° * 

e * 
o302382sALL * 

HEHE HEE DD He HEE EE HE * 
* INITIATOR * * 
* AND * # 
* INTERRUPT HX coos 
* ANALYZER * * 
* * * 
HEKEEHEREERRREKREE * 
x * 

‘se * 

* 


e 

0502278 sALL 
RERHEED EE HEREEREE 
* 


* 


ND 


HOUSEKEEPING ni 
A 

CONSTANTS : 

* 


* eK 


RHAAHEEHE RHEE EER 
x 
e 
eXecccccceccce 
. 
° 


« YES 
o*e 
F2 Fe 
o* HAS *. 
e* USER NEW *. NO 
#. PSW SET UP et*ecee 
%e ROUTINE «* 
Be 0% 
Be ot 
x 
. 
eXecccceceves 


te Hee i ee ee eae ee eek ok ke KK Ok 


o* NEW *. 
e® OEVICE *%e YES * 
*%e ADDRESS TO BEe*ecces 


%e USED o* * 
He 2% * 
ee ot * 

x * 

e * 
eXeccccccccces 

e * 

e * 

« NO * 

o*s * 

H2 He * 
o* He * 


2«* COMMAND *« YES * 
*#eOP MODIFIERS e*ecceces 
%e USED o* 
Ke e* 
He ot 


eeee xX 


* # 
*#AA * 
* HO* 
HHH 


ak OK OK kk KK Kk KOK Ok OK KK KK KKK OK 


Required Modules and 


Wee eK kK OK OK 


HRERKEEREEEEAEAEKEKEKERERHKERHE EAHA EHREE 


OPTIONAL MODULES 


20264,ALL 
HHHREBQHH HE EH HEHE 
* * 
* * 
eoeo* SNTRY2 * 
* * 
* * 
HEMET HE HE HE HE HEE 
. x 
° 
° 
e 
e 
7 
e 
. 
° 
e 
e@eeeeeaeeeaeneaeae 


MMe He te Ke ee ok ok ee ie ae ok ke ok oe oo 


SCCCHCHOHS SE TOTES O SESSA EHEDEABELESELCSALES EE HEOSEOEESE 


REKRLKAEE KEKE EKREAREREAEKEAEERRKEREREE 


eecevesescoose 
e 
e 


. 
oSPs 0s ALL 

REREEE ZHUREREEERE 

* INITIAL * 

* NEw PSW * 
eoeX® SET UP ROUT * 
* * 

* SORG * 
EREK KEE EREREEEEE 


2SAs44sTsl 
HEHE GZHEEE HHH R HE 
* MULTIPLE * 


*UNIT ADDRESS - * 

eeeX*DEVICE ROUTINE * 
* SCHGU is 
* 


HEKKKHREAREEAKHEH 


e@eeeoeveeeeoeeee 
e 
e 
. 
058 s40sDTsT eC 
HERA ZH EHH HERE 
* 


* 


* COMMAND * 
eeeX*OPER MODIFIERS * 
* ROUT * 
* SMODF * 
HE HE 


tit toe eee eee eee ER RES SES RE SRR SES RP SSSR SE REPS SREP RSE SEE ES SS 


Interrupt Action Modules 


30.56 
RHR AS HE HE EE 
* * 
#EXTERNAL INTER-* 
eecee*® RUPT BASE ¥ 
* ROUT INE # 
* SXTRIN * 
HRAKMHKEEEEEKEKRHHE 


3AsB82sALL 

HE TE BS EE EE 

* * 

* ERROR * 
Xeeee*INDICATOR GROUP* 
* SIND * 

* * 


HAAKKHHHEKEKHEK HEHE 


3Fe12 

HKEEKCSH RHKKRKEEHRHH 
* MINOR * 
* INTERRUPT * 
Xeeoe*® CONDITIONS * 
* SNTPX1 * 
* + 

& 


pererererrrirrr tr? 


3K 396s ALL 
RNR HH OS HR EHH REE 
* * 
* ISSUE * 
eooee*® INTERNAL CALL * 
* SNTCL * 
* * 


RKKKHKKLKKRAKLHRRK 


3Ls80eTsDT si 
HERRKES EKER HEHE 
*® INTERNAL UNIT * 
* SENSE ROUTINE * 


Xeeec* * 
* SENS * 
* * 


HRAMEKHKHKEHRHEHKREKE 


3Ms125 ALL 
HEREKES RRR RERERERE 

* cci UNIT * 

* INDENTIFIER #* 
Xeoos® * 
* SCCIN * 

* * 
HERE EE ERE R HERE EK 


3Ns46s ALL 
HEKURH GH EEN ARE RERE 
* SET YP * 
* PSws * 
Xooee® * 
* SION2 * 
* ® 
EERE EEE REE H EERE 


B0+505 ALL 
MME HH LS EE aE a 


# MACHINE CHK * 


* INTERRUPT * 
Xeooee® ENTRY * 
* SMCIN * 
* * 
HH He HEE EE HEE HE HE 


DO s8sTsDTslL 
RELKE JS ERNE EERE 
* UNIT CHECK - * 
* ROUTINES 
Xeee “3 


* 


* 
* 
SNKX * 
* 
HREM RHEE EE 


FOs8sALL 
HN HS EE EH 


* UNIT EXCEP * 


eoeeeeoeeeeeoeeeese ee eeeeeeee eset FEeeeeoeseeeeeeHeHnenetHeoeeHHeeeoHee HEH ERO HOCH HEHEHE RHEE KE KO oes eseveseeoseeseeeeseeseseeeseeeseeseneeeeoeee 


* CONDITION * 
eoeee® ROUTINES * 
* SUEX * 
* * 
HRN R EERE EE 
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* * & % * * 
#AA * *AA * SEE * *AA % 
* BS* * DS* * EQ * FS 
HEKHK HHKHE HH HHH HHH 
x x x x 
. . . . 
. ° 3K 296s ALL ° H1+24,ALL ° 3Me12s 
HHBQKHK KKH E RHHHKHYBHHHE KEKE HHHKEHRGGRERKRKKRHES HREKE BS ERE HKEHHHE 
* * * ISSUE * * WRITE * * cC1 UNIT * 
* ERROR * * INTERNAL * * MESSAGE * * IDENTIFIER * 
* INDICATION * * CALL * * ENTRY * * * 
*® GROUP * * * * * * * 
* * * SNTCL * * SWMSW * * SCCIN * 
MRK KHER HE HHH THK HHH HRAKHKKHHHHKKRHHHREH HEARSE KH EHH HEH 
x x xX x 
° . ° . 
. . . ° 
° ° . 
. Perc rc ccc cccncerencccsccccrerscccccesces . 
. . . 
. 3As82+ ALL . 
HHKKK CI HEHEHE KH HEE < e 
* WRITE * ° e 
* ERROR MESSAGE * . . 
% BASE ROUTINE 9 Feccccccvccccccccccereccccccasserssccesensesceseseseeesereseseseseseses 
* * . 
* SIND * 
Fe HE EH HE IE TE HE SE ESE EE HE EE 
HHH 
* * 
* AK *#Xee 
* ES* « 
RHEE 6 
3E 294 3B+2140 . 3L2809TsDT ol 
HHKEEKD ] HHH HHH HEE MHKRKH DDE THHEMEKKKE HEHKEOGHHAHHAHHHHH 
* BIN-TO-HEX * * WRITE * ® INTERNAL UNIT * 
* CONVERTER * *® ERROR ROUTINE * *# SENSE ROUTINE * 
* RKXewccevee® EXPANSION 1 * * x 
* * * * * * 
® SSENX * * SINODA * * SENS * 
KHER KEK KHHK RHR KKK HEME KKHHK RHA KEKE HRHKHKAKAHKHRHAHHHH 
x x 
. . 
. ° 
° . 
° 3C +70 e 
KHKHKKEQKHRKKHKHHH . 
* WRITE * . 
* ERROR ROUTINE * - 
* EXPANSION 2 Heccccesccscesccscseseccecersseocesessececeseses 
* * 
* SINOB * 
KRRKKKKKKHKRKRAKHHER 
x 
x * 
eAA * 
* C5S* 
KHHKK 
x 
. 3F,12 NOTE 36:12 NOTE 3Hs12 NOTE 33912 
RRGL RR EH REE HHEHH GOH HERE RHHHRHK HEAKKGGHHKRKKKHHKE HERKEN GG ERE KREMER HRHRE GS HRRKREHHEE 
® MINOR * * MINOR * * INCORRECT * ¥PROGRAM CONTROL® * ATTENTION * 
* INTERRUPT * * INTPYT CONDS * * LENGTH * * INTERRUPT * * BASE ROUTINE * 
* CONDITIONS BKewccccee® BASE * * RECORD * * BASE ROUTINE * * * 
* GROUP *% * ROUTINE * # BASE ROUTINE #* * * * * 
* * * SNTPX1 * * ‘SNTPD 1 * * SNTPD 2 * * SNTPD 3 * 
KHHEHRHREK HEH MRR H KKK EHR HER HE RHMRKKKAHKHHKHRHER KRHKKAAHKRHKRHHKHHREE HKEHMAH HK AKRAKA HH HE 
x e ° . 
Xx ° 
CCPC e ee MOOT OHH ESHER SESE EES EES EEEEEHETE EEE CEESO SEE OSE EE SS EHE SORES ES ESOS EE FEE 
3K 296s ALL 
KHHEK JG KRRKHKKHHK 
* ISSUE * 
* INTERNAL CALL * 
* Rececccce 
* x 
* * SNTCL * HRKHE 
% HHKEKRH KHNL HERE HAA *& 
*AA * * DS* 
% ES* % - 
NOTE HHH KE * 
THE FUNCTION OF THIS ROUTINE x 
IS TO PROVIDE FOR THE ATTACH ° 
MENT OF USER SUPPLIED ° 
ROUTINES THAT HANOLE THE . 3L»s80sTsDTsL J0s40%TsDT 
INTERRUPT CONDITION HR KDHE HK HEHE KK GHEE HH ERE HEK HHH KG HERR HE EK 
i * * * INTERNAL UNIT * * SENSE * 
* INTERNAL * % SENSE ROUTINE * * ENTRY * 
& SENSE CALL. * * KeccccceeX* Foeeccoecve 
* GROUP * * * * * x 
* % * SENS * * SSNSW * HHH RH 
KKK KKKHKKE HHERKAKKKKHEKEKKHH HRKRHRKHKKKKKHHKHEHKE *EE * 
% Gi 
e 
* 
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* OR 
*AA ¥ 
* GSt 
HREEK 

x 

. 

. 


HB ] Oe 
MACHINE CHECK 
* I/70 AND 
*® EXTERNAL NEW 
* PSwW SET UP 
* + 
FETE HEH EE EEE 


eo 
SAA ® 
* JS* 
HEGRE 

x 

. 

: 


« 
RRE LER HEE 


% 


* 


RRKKEBOERKHHKKREEE 


* 
* 
BXecccneee® 
* 
* 


RHKRKHKHHEKHHRHHE NE 


HRHKREE DH REKEREEER 


SET UP 
NEw 
PSw 


SION 2 


3N 246 sALL 


* * 
* * 


SAVE 
AND RESTORE 


H#Xecceesee* EXTERNAL PSW 
* * 


* * 


DO s20eTsDTeL 


SION 4 


HREKKHKEKKRERHHREHHE 


HHH HE GRRE ERE RERE 


3P,35 


HHEKHB OHHH HHRHHE ES 


* 


* 
* 
* 
* 
* 


DS5s162sTsDTst 
HHLERE GREEK RREKEE 


3L280sTsDT ol 


* * * UNIT CHECK * * UNIT CHECK * * INTERNAL UNIT * 
* UNIT * * BASE ROUTINE ¥* * TAPE ROUTINE * * SENSE ROUTINE * 
* CHECK KXeccseccce® FX ecccceee® KececceeeX* Kecccence 
* GROUP * * ¥ * é * * 
® * * SNKX * * SNKT * . * SENS * HKKEE 
RMR RHEE HEE MME RARER RHE EERE HHKHHRRRHRHKRRAKHRE e KKK KKKKEELERREERE *BB * 
% KB*" 
HHH - * * 
* * ee * 
t * G3 *Xee . 
* ee * 
HREE Pa 
D7 9124eTsD2eL . D6s 142sTsDTs6 . 3K 396eALL 
KRRKRHG 1] ER RK BER ERE HRHEKGSHRRHERRRER . HKU GREK HKRHR KKK 
* TAPE * * * . * ISsuc * 
* READ * #* TAPE RETRY * . * INTERNAL & 
* RETRY KeccccccccsccccsveXeccccsscsccccnseeX*® * eee Xt CALL Kececvcece 
* * * * * é * * x 
* SBKSP ® ° * STRET * ° * SNTCL * HHA 
HRMRERCEERKKK KHER e KKK KKEKRRRKKKHERE = REAR KHKERKRKEAHHKHKR *AA * 
° . ‘e * DS* 
is é HREK = x % 
. . *# * é * 
e eXe* GZ * ° 
e ° * * . 
= e HHRE é 
° 08:68+T,»Di x MOs46sTsOTsL KS 2209TsDT ok 
HEHEHE KHER REESE HRA RH GREK RH HH EEE é HHKRHERHG HH RHEE EE 
* TAPE * * ISSVE * ° * TAPE BKSP * 
* WRITE * *# CONTROL COMMAND*® . * RECORD ENTRY #* 
* RETRY * * * eeeeX* Hooesecee 
* # * * ‘ * * x 
* SEFwoO * % SCTLW * ° * SBSRW * HRERH 
RHEE HHH KEKE RRHKKHEHKRAHAKRKEKKEK e KEKE KKKHKHEKHKREE *#FF * 
. ° * FOX 
< . * % 
° . * 
x ° 
RHEE = 
*EC * e 
*% C1 . 
HHREEH IQR RHEE e * is HR SGM HEHE RHR 
* * * . * FORWARD SPACE * 
* REWIND ENTRY ¥* . * TAPE RECORD # 
* * ooeX* ENTRY Kecccccee 
* % * x 
* SRWD * * SFSRW * HH HE 
HHH HEHE HH HREK EHR E HERE REESE *FF 
. * G2* 
a % 
* 


Chart CC. 


x 
REKEK 
HPF # 
* E2% 

H % 


I/O Base Routine - Group 1 PSW 


Routines, Machine Check Group, Unit 


Check Group 
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* * 
HAA * 
* KS* 
HEE 
x 
e F028 »ALL F2e10sALL 
HKD 1] HHH RHE RRKEAQHLKMKEKEHEREKRE HEKKAP ZRARRRKKHKE 
*# EXCEPTIONAL *® * VE * * SET UP * 
* CONDITION ¥* * BASE * *  EXCEP COND * 
* GROUP KXeeccccce® ROUTINE FX eececeee*RETURN ADORESS * 
* * * * * * 
* * * SUEX * * SUEXR * 
REKKKKEKHHEE KRKEKKRERKEKKEKKKRKERE HRERKEKKERHKKKHKRKEE 
x 
e 
e 
° 
° 
° 
oF1ls20sTsDTol FS.s80»D2 3L. »s8OeTsDT ok 
HHKKEKECORHKRKKRKRERE KREKEKRCZFHHHRHKKKHE RHEERCKKHREKKRHRRER 
* VE * * UE * * INTERNAL UNIT * 
* SPECIFIC UNIT * * PRINTER * * SENSE ROUTINE * 
* BASE ROUTINE *#Xecccecce® ROUTINE BeccccceeX® Fececcces 
* * * ® * * x 
* SUES * * SUEP * * SENS * HH EH 
KREKRKKKAKRAHERKRHKE RHERKEKHKEKRKEAKHHKEERE RERKAKRKRAKAKEHHKREREKR *BB * 
e * KO 
e e & 
@eeeaeeeneaneeeeee * 
es eo 
e e 
e . 3K 996eALL 
e e HEKEKKE DH GHHEKREKRKKEKE 
e ° * ISSUE * 
e e * INTERNAL CALL * 
e aoe X* Keccccoce 
° * x 
e * SNTCL * HRERE 
e HRERKARAKRKHRAHRKEAKKE *AA * 
° * DS* 
e * # 
e * 
e J32362TsCsDS2D2 
bs HH MRE A EEE 
. * SKIP-TO~1 * 
e * ENTRY * 
eeorccveccaosccescesX* BFecccccce 
* x 
* SKIPW ” REE RH 
HREEETRAARERKEKRARARR *EE * 
* GS* 
* 
* 


Chart DD. Unit Exceptional Condition Group 
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* & 
*AA * 
* HO* 
HRRHKE 
x 
REQUIRES e 
COMMAND Py 
MODIFIERS ° 
ROUTINE HRB AERA EEE 
*CALL ENTRY * 
* MODULES FOR * 
*#CARD MACHINES. * 
* CONTROL ANDO * 
* * SENSE * 
* *& RK EREKHEE 
#AA * x 
* H3* . 
eres a 
x . 
e ° 

NOTE 3 oMO 546 o*e . NOTE 2 HOs24eTeColsOT NOTE 2 H4s160TsCsDi 
RHEE | RHEE ERE c2 Re ry RHEE CH EHHEEKRHHREEE REKEKECSRREKRHHHRERE 
* ISSUE CONTROL * e*LOCATE *e ° * READ * * * 
* COMMAND * e* BY GIVEN *. NO ° * CARD * * PUNCH * 
* FeccwoeeeXFeWAIT ADDRESS et eccevcccccccccseXeXevcccccccesccvee® WAIT SROCW eXecccccoe*® (1442) * 
* SCTLW * #e o* ° * * * SPCR * 
* Ke o* ° * : * * * 
HERA EEE EHEHHE %e ot e MUNK KHKKERAERERE HE KRENEK EREERHHE 

* YES ° x 

e ° °° 

e .2 ° 

e ° e 

° ° ° 

° ° ° 

XN220 . . NOTE 3 J4s202T2CsDi 
REKRRE DO QHAAKKEHKEN e e HRHKEKEDS REMEBER HEHEH 
* CONTROL ENTRY * ° . * * 
* LOCATE SINTRY * e . * PUNCH WAIT * 
*TBL BLOCK EXIT * . PeeccccececcccceseXk (1442) # 
* SCTLX * . * SPCRW * 
* * . * * 
HEKRARKKEHREREMERERE . HRAAKEKRHEKKEKREREKE 

° e 

° e 

. . 

. ° 

e . 

° . 

XNOs36 . NOTE 2 H1 »24sALL NOTE 3 J1s32eLsDTsDS 
HHEREEDEHERKKRHEKE ° HRKRKKHKE EERE KRHHAEE HEHRHES RHHKHKHEKE 
* LOCATE SINTRY * ° * * * * 
* TABLE UNIT * e * WRITE MESSAGE * * SINGLE SPACE * 
* BLOCK FewccsccccwvccacesXeXeccscsvcsccccsen® SWMSW ¥Xeececoee*® MESSAGE UNIT * 
* SNUDE * . * * * SPCMW * 
* * e * ¥ ca * 
KEREKEREKEKREKEKE e HRRRKEEKREREKEEREEE RERAEKRKKHRKRELEARHEE 

x e 

e ° 

. ° 

. . 

. . 

. ° 

oN1.0 ° NOTE 2 H2s24eTsCeD2.DS NOTE 3 J2232:302:0S 
HHHERFOREREHRREREE . HHH GREER HEREKE KKKEKESRHRKREKHHER 
* SENSE ENTRY #* . * * * * 
* LOCATE SINTRY * . * * * SINGLE SPACE * 
*TBL BLOCK EXIT * eXecccccccsccccsec® PRINT FXecscccee® PRINTER * 
* SSNSX * ° * SPRTW * * SPCPW * 
* * . * * * * 
KRHKHRKRHERRERERKEE . HRATKEKMREREREKHAEKEK KKKEHRKEKEREKRTERKE 

x . x 

. . . 

. ° . 

. e . 

e . . 

e YES . . 

NOTE 3 JO 240 oT st pDT o*e ° . NOTE 3 J3236sT2sCsD2,0S 
HREEKG | FRR REE REK G2 Xe e e HEHKA GH HERR HRRHKRE 
* * e* He . . * PRINTER SKIP * 
* «ISSUE SENSE #* 0e* LOCATE *e NO ° . # TO CARRIAGE ¥* 
* COMMAND BecccceveeX*eBY GIVEN UNIT o¥ ccc wccccvcccsccexe emeccccccscccccsee® TAPE ONE * 
* SSNSW * *. ADDRESS e* e * SKIPW * 
* * ¥*e e* . * * 
KERR EE LEK LER ERE Fe «% e KRKRAKHKEKKKKREKERKEE 

* . 

. 

e 

° 

. 

e 

e NOTE 2 H329209TsCsDi NOTE 3 JS2165TsCeDi 

e HEEKEY GE REKHERKEHRER HREKAHPYS KKH HRRAHRRRH 

. * * * ; * 

. * PUNCH * *% PUNCH WAIT * 

eeccccccccccccccceX® (2540) BXecccccee® (2540) * 
* SPUC * * SPUCW % 
* * * * 
MEG KRKKKKEEKRKEKHRE KEK KKKHRERKKERKHKE 


NOTE 2 - REQUIRES PRESENCE OF ADDRESS TO 
ENTRY IN SINTRY TABLE 


NOTE 3 ~ REQUIRES PRESENCE OF ADDRESS TO 
ENTRY IN SNTRY2 TABLE 


Chart EE. I/0 Call Entry Group Modules for Non-Tape, Sense, and Control Operations 
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* 
* * 
HAA * 
* HO" 
HEHEHE 
x 
se 


° 
HR BIRR HHKER 
* TAPE * 

*% OPERATIONS #* 
* ENTRY * 
* GROUP * 
* * 
HEH HHH KEE 
x 


e 

eKOsS6eTslsDT 
HHH C ZIRE RHEE EHEE 
* TAPE * 
* ENTRY * 
* BASE * 
* ROUTINE * 
* STPBKW * 
HH HEHEHE EEK 
X 


K1s20eTst»2D2 K2220eTsD1 

HEKREEDDERRRKEERERE KHRHKRDGHEKRKKEKRHREK 
* * * * 
* READ * * WRITE * 
* TAPE HeccccccccceneceeX KewececsececccseccseX TAPE * 
* SRTPW * * SwTPw * 
* * * * 
* 


HREKEKHEERHKEEKKERE 


HREKHKAFKAKAKERAHEKE 


K30249T+sDT K42200TsD1 


eeeeoeveeeveeeeesvespeeee eee @ 


HHEKRKEEDEREREEEKRE HRHEKKKEGKRHHHRKEKEREN 
* * * WRITE * 
* REWIND * e * TAPE MARK * 
* HBeceaccscecesceseeXeXecsasesesesesoeekt * 
* SRWD ° * SWTMwW * 
* * e * * 
KRKKKRKRKRKEERRAKREKEE e HRKFKRKRKKKKKREKRKKKE 

J 

e 

e 

e 

e 

e 

K5s20sTsl,OT e K6 »20eTsL 

HHHREFZERHREHE EEE e HREHHKEGRERHHRKHEKE 
* BACKSPACE * e * BACKSPACE * 
* RECORD * ° * FILE * 
* HeccascccscccccsaexeXecesesesevocesee® * 
* SBSRW * e * SBSF * 
cd * e * * 
RARER RKKHHRKKE ‘~* HREHKKRAKAKAHKKEHRRHKE 

e 

e 

e 

oe 

e 

J 
K7220,T,D2 ° K8s205T 
HRRAKEGORKAEKRHEEHE e HEKKKGHEHREKKKRKRKEE 
* FORWARD * e * FORWARD * 
* SPACE * . * SPACE * 
* RECORD Bocce eccceveccecveexXrerXeesecccessescesasXk FILE *® 
* * e * * 
* SFSRW * . * * 
HARRAH KE e HKKHKKEHHHRHKKHKNE 

ee 

e 

e 

e 

e 

J 
° K9s200T 
e HREKRHREHGRAKEKKRKRER 
e * READ * 
e * BACKWARD * 
ececcccvcccccccoseck = * 
* 
* SBRTW * 
HHEKHKEKRKMHERHEHE RH 


REQUIRES PRESENCE OF AODRESS TO 
ENTRY IN SNTRY 2 TABLE 


Chart FF. 
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I/O Call Entry Group Modules for Tape Operations 


* 


* 


* 


The programmer often finds it necessary 
to use subroutines and other program seg- 
ments that he himself did not produce. In 
most cases, the programmer knows the call- 
ing sequence of these routines; however, 
the assembled location or the size of these 
routines usually is not known. In using 
the relocating loader, the question of size 
may or may not be of concern to the 
programmer (depending on the storage capac-— 
ity of his machine) and the question of 
assembled addresses is of no concern, since 
the loader will load and set up linkage 
between these various routines. 


When relocating program segments and 
establishing linkage among them, the relo- 
cating loader must calculate certain infor- 
mation during the loading process. 


The loader receives the information to 
answer these questions from the load cards 
that it encounters during loading. Some of 
the information that the loader receives 
must be saved for later use during the 
loading process. The information that is 


saved is placed in the Control Dictionary, 


which is compose two tables, one ca 
the Reference Table and the other the 
External Symbol Identification Table. 

The External Symbol Identification Table 
is contained in the loader itself. The 
Reference Table is built downward from the 
highest available storage address (location 
8191 in the low version released by IBM), 
each entry (a maximum of 253. entries) 
consisting of 12 bytes. The Reference 
Table is protected from being overlaid when 
input to the loader is in relocatable form. 
However, during an absolute load, the Ref- 
erence Table is not protected and may be 
overlaid. 


The information required by the loader 
answers the following questions: . 


1. What are the names (program name, 
entry points, and external symbols) by 
which this segment may communicate 
with other program segments, and what 
are the actual addresses of these 
names? A program segment (or 
subroutine) may be referenced by other 
program segments: if the segment which 
is referenced is in storage at load 
time, the address of the segment is 
already established; if it is not in 
storage at load time, the name and 
entry points must be defined to the 
loader by an ICS card (and SLC card, 
if necesSary) . (These assigned 
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addresses are kept by the loader in 
the Reference Table.) 


2. What address constants within the 
assembled segment would change value 
as a result of this segment or another 
segment being relocated? During the 
loading process, the loader is noti- 
fied that adjustments are to be made 
within this program segment by the ESD 
cards (types 0 and 2). It is told how 
and where these adjustments are to be 
made by the RLD cards. 


3. What is the relocation factor; that 
is, what is the difference between the 
assembled address of the segment and 
the address where loading will begin? 
This factor must be added to or sub- 
tracted from the assembled address of 
the program name and any other entry 
point to the segment, and the assem- 
bled address in all Text and Replace 
cards. 


Example 


In order to illustrate, step by step, 
how the loader accomplishes relocation and 
linkage, we will assume that there are two 
program segments to be loaded, SEGA and 
SEGB. 


in SEGB 
SEGA defines SORT 
symbols by these 


SEGA refers to two subroutines 
called SORT and LINK. 
and LINK as external 
assembly instructions: 


SEGA START 128 
EXTRN SORT 
EXTRN LINK 
During execution, SEGA can branch to these 
external subroutines, thus: 
L 15, ADSORT 
BALR 14,15 
L 15, ADLINK 
BALR 14,15 


Address constants are generated for them in 
this manner: 


ADSORT DC 
ADLINK DC 


A (SORT) 
A (LINK) 
SEGB refers to SEGA by its 
which is an entry point. 


program name, 
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SEGB must define SEGA as an external sym- 
bol: 


EXTRN SEGA 
and generate an address constant: 


ADSEGA DC _ A(SEGA) 


to allow a branch and link operation. 


Note that SEGA does not yet have the 
actual addresses it needs of SEGB, nor does 
SEGB have the address of SEGA. These 
addresses will not be assigned until load 
time. The ESD and RLD cards produced by 
the assembler for each segment provide’ the 
information the loader needs to complete 
linkage. 


To illustrate the use of the relocation 
factor (see point 2 on the preceding page), 
the example in Figure 13 assumes that SEGA 
was assembled at storage location 500 and 
has a length of 200 bytes; that SEGB was 
assembled at storage location 400 and has a 
length of 100 bytes; finally, it assumes 
that the programmer desires to load the 
segments beginning at location 1000. Note 
carefully that this procedure requires a 
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Set Location Counter card to set the ini- 
tial loading location to 1000. Also note 
that since SEGB refers to SEGA by name, an 
Include Segment card is also necessary to 
establish the location and length of SEGA 
before it is loaded. 


Figure 13 illustrates the loading proc- 
ess. It shows how each card is generated 
from the user's source deck, through assem- 
bler operations, to assembler output and 
onto load time. Finally, the figure illus- 
trates the appearance of storage after 
loading. The five columns of Figure 13 are 
read left to right following the flow noted 
in the previous two sentences. 


Each card 
letter mnemonic: 
forth. 


is referred to by its three- 
SLC, ICS, ESD, and so 


Other abbreviations used 
are: 


in Figure 13 


ESID for External Symbol Identifi- 
cation 
LOCCT for Location Counter 


REFTBL for 
ESIDTBL for 


Reference Table 
External Symbol Identifi- 
cation Table 


User's Problem Progrom 


SEGB 


ADSEGA 


ADSQRT 
ADLINK 


Figure 13. 


START 400 


ENTRY SQRT 
ENTRY LINK 


EXTRN SEGA 


. 
. 


. 


L 15, ADSEGA 
BALR 14,15 


pC —A(SEGA) 


START 500 


EXTRN SQRT 
EXTRN LINK 


15, ADSQRT 
14,15 
15, ADLINK 
14,15 


A(SQRT) 
A(LINK) 





Assembler Output 


Programmer inserts SLC card for location 
1000; ICS card to define nome, length of SEGA 





Storage After Loading 


é 
Assembler Operation Loader Program . .. LOCCT 
Aureob les Spee ES Sets LOCC of 1000 
Fo ol +— Enters SEGA in REFTBL with location from LOCCT; 25 an ene 

increases LOCCT by length of SEGA (200) 

Type 0 ESD card with program LOCCT 

name, location and ESID (01) ESD (Type 0) — Enters SEGB in REFTBL with location from LOCCT; 
figures relocation factor (800), puts this in REFTBL ~ REFTBL ~ Ot” 
with SEGB; puts number 2 in ESIDTBL as pointer to (1) [SEGATi000 |_| 

in R 3a . 9 
Type 1 ESD cords with name of SEGB entry in REFTBL; increases LOCCT by length of (2) [SEGB 11200 {800 _] 
SQRT and LINK assembled addresses ESIDTBL LOCCT 


(450 and 480), and ESID (01) 


on C27) 


| 


SE 1 
ESD (Type 1) SEND, 
—— Enters SQRT and LINK in REFTBL, adds relocation 
factor to get actual locations 
ESD (ype 2) ——Finds SEGA is first entry in REFTBL; enters the number 


Type 2 ESD card with name of 


SEGA and sequential ESID (02) 1 in ESIDTBL os @ pointer to SEGA's entry in REFTBL; 


enters 1000 as current relocation factor 


TXT cards with instructions and 
constants in binory, and location of 
area tobe loaded from each card 


——— Adds relocation factor to address of each cord 
and loads its contents into core storage 


Goes to entry 02 in ESIDTBL, finds pointer to first 
entry in REFTBL; gets relocation factor from REFTBL, e 
adds to contents of ADSEGA. This linkage is 





RLD card with Relocation Header 02 
and location assigned to ADSEGA 
(whose contents are zeros) 


END card with no address for transfer 
of control 





Type 0 ESD card with program name, 
location and ESID (01) 





Finds SEGA and location in REFTBL; figues reloco- 
ESD (Type 0) 
in REFTBL, starting new round of ESID numbering 
Type 2 ESD cards with names of SQRT 
in binory, and location of area to be 


completed 
—— Ends loading of SEGB, saves location as conditional 
point for transfer of control. Erases ESIDTBL. 
tion factor (500) and puts in REFTBL with SEGA; 
puts number 1 in ESIDTBL as pointer to SEGA entry 
— Finds SQRT and LINK are third and fourth entries 
and LINK, and sequential ESID (02,03) ESD (Type 2) in REFTBL; puts numbers 3 and 4 in ESIDTBL as pointers 
to REFTBL. Makes entries for relocation factor 
TXT cards with instructions and constants 
I r : 
Iscdad few sach.cord oads its contents into core storage (01) 
(02) 
(03) 





i 





RLD cards with Relocotion Header (02,03) Goes first to entry 02 in ESIDTBL, finds pointer to REFTBL 
and locations ‘acsioned 40 ADSGIRT ond RLD third entry in REFTBL; gets relocation factor from a}) 
ADLINK (whose contents are zeros) REFTBL, adds to contents of ADSQRT. Repeats proc- 
ess for ADLINK (2) 
ENO card with address of SEGA for —— Ends loading of SEGA, saves specified location os ac 





conditional point for transfer of control (superseding 
previous location saved) 


transfer of control 


LOT card with no ad- pt transfers control to address previously saved (SEGA) 
dress for transfer of 


control 


Programmer inserts - ~—- Ends al! loading and, since card specifies no address, 


Example of the Loading Process 
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APPENDIX B: SELF-LOADING PROGRAM GENERATOR (LDRGEN) 


LDRGEN is a program designed to 
regenerate loader program decks into a form 
suitable for direct loading into storage. 
Furthermore, since neither the absolute nor 
relocating loader is provided ina form 
that can be relocated, LDRGEN can be _ used 
by an installation to cause the loaders to 
occupy locations in storage other than the 
locations they occupy in the versions 
released by IBM. 


REQUIREMENTS FOR USING LDRGEN 


LDRGEN is provided only in symbolic form 
and therefore must be assembled by the 
user. Similarly, the absolute and relocat- 
ing loaders must be assembled at the loca- 
tions desired by the user. Prior to assem- 
bly of the LDRGEN program, the user must 
provide LDRGEN with the address of the 
output device: he does this by means of an 
Equate instruction that he inserts into the 
LDRGEN deck immediately before the END 
card. It is coded as: 

OUTPUT EQU (address of the output 
device in hexadecimal 
or its equivalent 
decimal notation) 


The assembled loader deck and LDRGEN 
programs can be loaded into storage by the 
absolute or the relocating loader. 


CAUTION: the versions of the loaders 
released by IBM occupy low- or high-storage 
locations on an 8K configuration. Since it 
is necessary to load the assembled reloca- 
table decks of both LDRGEN and the loader 
being regenerated, care must be taken to 
ensure that neither of these will overlay 
the loader loading them. In other words, 
all must fit in the storage of the machine, 
remembering that the self-loading loader 
occupies predetermined locations and the 
loader being generated must occupy the 
locations where its residence is desired. 


The loader program must declare the 
following information to LDRGEN: 


1. The lowest storage address occupied by 
the loader; this address shall be 
called ALPHA. 


2. The loader initial entry point; this 
address shall be called BETA. 


3. The availability of an area of at 
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least 160 bytes for the 
residence of the bootstrap routine; 
this area shall be called IOTA. (The 
address IOTA must be on a_ double-word 
boundary.) IOTA should not be includ- 
ed within the loader (that is, between 
ALPHA and OMEGA); it should be adja- 
cent to the loader. This may be coded 
as: 


temporary 


IOTA EQU *-160 


to reside below the loader or as: 
IOTA EQU * 
to reside above the loader. 
4. The highest storage address plus 1 


occupied by the loader; this address 
shall be called OMEGA. 


PROVIDING ADDRESSES 


As was pointed out, LDRGEN is loadable 
by either the absolute or the relocating 
loader. Both loaders define ALPHA, BETA, 
IOTA, and OMEGA by ENTRY assembler instruc- 
tions; therefore, these addresses are sup- 
plied to LDRGEN in one of two ways, depend- 
ing on whether the absolute or the relocat- 
ing loader was used to load LDRGEN. 


If the absolute loader was used, the 


addresses are supplied to LDRGEN by Replace 
cards: 


Into LDRGEN 


Assigned to at Location 
ALPHA ALPHAA 
ALPHA ALPHAB 
BETA BETAA 
IOTA IOTAA 

OMEGAA 


OMEGA 


If the relocating loader was used to 


load LDRGEN, the linkage is supplied 
through ENTRY assembler instructions. 
LDRGEN defines these addresses through 
EXTRN assembler instructions. IOTA should 


be designated by the loader program as a 
buffer area. This area is temporarily 


-occupied by the bootstrap routine, but it 


is available to the 
execution time. 


object program at 


Finally, LDRGEN provides the facility of 
producing duplicate decks; there is a half- 
word in LDRGEN called CON. This location 
is originally assembled with a value of 
one. However, if the user desires more 
than one copy of his deck, he may change 
the value in CON, by a Replace card, to any 
desired value. The value in CON will be 
decremented by one after each copy of the 
deck is made and will continue to make 
copies of the deck until the value in CON 
is reduced to zero. 


SEQUENCE OF OPERATIONS 


The following is the 
operations of LDRGEN. 


sequence of 


1. It calculates the difference between 
ALPHA and OMEGA; this gives LDRGEN the 
size of the object program it will 
write. 

2. It adjusts the bootstrap (160 bytes) 
address to the designated area -- 
IOTA. 


3. It issues a write command for: 


a. One 24-byte card containing the 
IPL record (Initial Program lLoad- 


ing PSW, Initial Program Loading 
ccwi1, Initial Program Loading 
CCW2) , 


b. Two 80-byte cards 


containing the 
bootstrap routine, 


c. A series of 80-byte records, of 
which the first 72 bytes are text, 
containing the loader program in a 
form suitable for direct loading 
into storage (that is, the con- 
tents of ALPHA through ALPHA+71, 
ALPHA+72 through ALPHA+143, etc.). 
These cards will be sequenced in 
columns 77-80. 


After the entire program has been 
regenerated, it writes an END card 
using the address of BETA as the 
initial entry point to the loader. 


It examines the count to see if dupli- 
cate decks are to be written. if 
there are duplicate decks to be made, 
the sequence of operations begins 
again at item 3. 
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